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Preface 


About This Manual 


This is the reference manual for the Apple® He personal computer. 
It contains detailed descriptions of all of the hardware and firmware 
that make up the Apple IIe and provides the technical information 
that peripheral-card designers and programmers need. 


This manual contains a lot of information about the way the 

Apple Ile works, but it doesn’t tell you how to use the Apple Ile. For 
this, you should read the other Apple Ile manuals, especially the 
following: 


a Apple Ile Owner's Guide 
0 Applesoft Tutorial 


This manual is designed to answer the question “What’s inside the 
box?” It describes the internal operation of the Apple Ile as 
completely as possible in a single volume. 


Contents of this manual 


The material in this manual is presented roughly in order of 
increasing intimacy with the hardware; the farther you go in the 
manual, the more technical the material becomes. The main 
subject areas are 


introduction: preface and Chapter 1 

use of built-in features: Chapters 2 and 3 

how the memory is organized: Chapter 4 
information for programmers: Chapters 5 and 6 
hardware implementation: Chapter 7 


OoOoado0od0o000 


additional information: appendixes, glossary, and bibliography 


xvii 


xviil 


Chapter 1 identifies the main parts of the Apple Ile and tells where 
in the manual each part is described. 


Chapters 2 and 3 describe the built-in input and output features of 
the Apple Ie. This part of the manual includes information you 
need for low-level programming on the Apple Ie. Chapter 2 
describes the built-in I/O features, and Chapter 3 tells you how to 
use the firmware that supports them. 


Chapter 4 describes the way the Apple Ile’s memory space is 
organized, including the allocation of programmable memory for 
the video display buffers. 


Chapter 5 is a user manual for the Monitor that is included in the 
built-in firmware. The Monitor is a system program that you can use 
for program debugging at the machine level. 


Chapter 6 describes the programmable features of the peripheral- 
card connectors and gives guidelines for their use. It also describes 
interrupt programming on the Apple Ile. 


Chapter 7 is a description of the hardware that implements the 
features described in the earlier chapters. This information is 
included primarily for programmers and peripheral-card 
designers, but it will also help you if you just want to understand 
more about the way the Apple Ile works. 


Additional reference information appears in the appendixes: 


Appendix A is the manufacturer’s description of the Apple IIe’s 
microprocessor. 


Appendix B is a directory of the built-in I/O subroutines, including 
their functions and starting addresses. 


Appendix C describes differences among Apple II family 
members. 


Appendix D describes some of the operating systems and languages 
supported by Apple Computer for the Apple Ile. 


Appendix E contains conversion tables of interest to programmers. 


Appendix F contains additional copies of some of the tables that 
appear in the body of the manual. The ones you will need to refer to 
often are duplicated here for easy reference. 


Appendix G contains information about using Apple Ile 80-column 
text cards with the Apple Ile and high-level languages. 
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Appendix H discusses programming on the Apple Ile with the 
Apple Super Serial Card. 


Appendix I describes the international keyboards and character 
sets. This appendix also contains schematic diagrams of the 
international circuit boards... 


Appendix J contains the source listing of the Monitor firmware. You 
can refer to it to find out more about the operation of the Monitor 
subroutines listed in Appendix B. 


Following Appendix J is a glossary defining many of the technical 
terms used in this manual. Some terms that describe the use of the 
Apple Ile are defined in the glossaries of the other manuals listed 
earlier. 


Following the glossary is a selected bibliography of sources of 
additional information. . 


The Apple Ile family 


Changes have been made in the Apple Ile since the original version 
was introduced. The first change resulted in a version called the 
enhanced Apple Ile. The latest version is called the extended 
keyboard Apple Ile. These versions are all described in this 
manual, Where there are differences between the original 

Apple Ile, the enhanced IIe, and the extended keyboard Ile, they 
will be called out in the manual. Otherwise, the three machines 
operate identically. 


Identifying your Apple Ile 


You can tell whether you have an enhanced or an original Apple Ie 
when you start up your computer: an original IIe will display 
“Apple ][” at the top of the monitor screen, while the enhanced 
Apple Ile will display “Apple //e”. The extended keyboard 
Apple Ile is easily identified by the numeric keypad built into the 
keyboard. 


The Apple tle family xIx 


Opcode |s short for operation 
code and is used to describe the 
basic Instructions performed by 
the central processing unit of a 
computer, 


The original Apple ile 


The original Apple Ile is the oldest member of the Ie family. It has 
the following features: 


0 the 6502 microprocessor 
0 64K of RAM 


O 40-column display (unless an optional 80-column text card is 
installed) 


The enhanced Apple Ile 


The enhanced Apple Ile includes the following changes from the 
original Apple Ie: 


O The 65C02 microprocessor, which is an improved version of the 
6502 microprocessor found in the original Apple Ile. The 65C02 
uses less power, has 27 new opcodes, and runs at the same speed 
as the 6502. (See Chapter 7 and Appendix A.) 


O A new video ROM containing the same MouseText characters 
found in the Apple IIc. (See Chapter 2.) 

© New Monitor ROMs (the CD and EF ROMs) containing the 
enhanced Apple Ile firmware. (See Chapter 5.) 

Q The identification byte at $FBCO has been changed. In the 
original Apple Ie it is $EA (decimal 234), in the enhanced 
Apple Ile it is $E0 (decimal 224). 

C Recent models of the enhanced Ile include the Extended 80- 


Column Text Card as a standard accessory, thus increasing the 
available RAM in the enhanced Ie from 64K to 128K. 


The enhanced Apple Ile includes a number of improved features in 
addition to the changes listed above. The following sections 
describe the improved features of the enhanced Ile. 


Startup drives 


You can use startup (boot) devices other than a Disk II® to start up 
ProDOS® on the enhanced Apple Ile. 


Apple IT Pascal versions 1.3 and later may start up from slots 4, 5, 
or 6 on a Disk II, ProFile™, or other Apple II disk drive. Apple I 
Pascal versions 1.0 through 1.2 must start up from a Disk II in slot 6. 


DOS 3,3 may be started from a Disk II in any slot. 
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When you tum on your Apple Ile, it searches for a disk drive 
controller to start up from, beginning with slot 7 and working down 
toward slot 1. As soon as a disk controller card is found, the 

Apple Me will try to load and execute the operating system found on 
the disk. If the drive is not a Disk II, the operating system of the 
startup volume must be either ProDOS or Apple II Pascal (version 
1.3 or later). If it is a Disk II, the startup volume may be any Apple II 
operating. system. 


Video firmware 

The enhanced Apple Ile has improved 80-column firmware: 

O ‘The enhanced Apple He now supports lowercase input. 

CQ Escape Control-E passes most control characters to the screen. 


© Escape Control-D traps most control characters before they get 
to the screen. 


O Escape R was removed because uppercase characters are no 
longer required by Applesoft. 


Video enhancements 


Both 80-column Pascal and 80-column mode Applesoft output are 
faster than before, and scrolling is smoother. 40-column Pascal 
performance is unchanged. 


In the original Apple Ile, characters echoed to COUT1 during 80- 
column operation were printed in every other column, the 
enhanced Apple Ile firmware now prints the characters in each 
column. 


Applesoft 80-column support 

The following Applesoft routines now work in 80-column mode: 
0 HTAB 

oO TAB 

oO SPC 

0 comma tabbing in PRINT statements 
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To find out more, see the Pascal 
ProFile Manager manual. 


Applesoft lowercase support 


Applesoft now lets you do all your programming in lowercase. 
When you list your programs, all Applesoft keywords and variable 
names are automatically in uppercase characters; literal strings and 
the contents of DATA and REM statements are unchanged. 


Apple Il Pascal 


Apple II Pascal (version 1.2 and later) can now use a ProFile hard 
disk through the Pascal ProFile Manager. 


The Pascal 1.1 firmware no longer supports the control character 
that switches from 80-column to 40-column operation. This control 
character is no longer supported because it can put Pascal into a 
condition where the exact memory configuration is not known. 


System Monitor enhancements 


Enhancements to the Apple Ie’s built-in Monitor (described in 
Chapter 5 in this manual) include the following: 


O lowercase input 

O ASCII input mode 

O Monitor Search command 
the Mini-Assembler 


Interrupt handling 


Interrupt-handler support in the enhanced Apple Ile firmware now 
handles any Apple Ile memory configuration. 
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The extended keyboard Apple lle 


The extended keyboard Apple Ie includes the following changes 
from the enhanced Apple He: 


O The new keyboard contains a built-in 18-key numeric keypad. 


O The Extended 80-Column Text Card is a standard feature. The 
card is shipped installed in the auxiliary slot. 


tf One 128K ROM IC replaces the two 64K Monitor ROM ICs (the 
CD and EF ROMs). 


0 Two 64Kx4 RAM ICs replace the eight 64Kx1 RAM ICs. 
O The single-wire Shift-key mod is standard. 


RAM upgrade 


Both the original Apple Ile and the enhanced Apple Ile are 64K 
machines, expandable to 128K through the use of auxiliary memory 
cards like the Extended 80-Column Text Card. The extended 
keyboard Apple Ile has 64K of main memory, mounted on the 
circuit board. However, because the Extended 80-Column Text Card 
is now a standard feature, providing 64K of auxiliary memory, the 
extended keyboard Ile comes “pre-expanded” to 128K of RAM. 


The eight 64Kx1 RAM ICs on the original and enhanced Apple Ie 
circuit boards have been replaced by two 64Kx4 ICs on the extended 
keyboard Ile circuit board. This means that the extended keyboard 
Apple Ile has two RAM ICs instead of eight like the original and 
enhanced Ile’s. Pin-out diagrams for both RAM IC configurations 
are provided in Chapter 7. 


Single-wire Shift-key mod 


The single-wire Shift-key mod is an option jumper point on the 
circuit board that lets the extended keyboard Apple Ile detect the 
Shift key with the mouse active. From a practical standpoint, the 
single-wire Shift-key mod allows mouse-based programs to use 
“Shift-click” control sequences on the extended keyboard Ile. 


The single-wire Shift-key mod option jumper is labeled X6 on the 
circuit board. 
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Warning 


Important 


Extended keyboard Ile 


Definitions, cross-references, 
and other short items appear in 
marginal glosses ike this. 


Symbols used in this manual 


Special text in this manual is set off in several different ways, as 
shown in these examples. 


Important wamings appear like this. These flag potential danger 
to the Apple ile. its software, or you. 


Text set off in a box like this Is less urgent or threatening than 
text placed inside a Warning box, but still of a critical nature. 


Text set off like this defines the differences in features or 
operation between the three versions of the Appie lle. 


* By the way: Information that is useful but incidental to the text 
is set off like this. You may want to skip over such information 
and return to it later. 


Terms that are defined in a marginal gloss or in the glossary appear 
in boldface. 


Words that appear on the screen are shown in a monospaced font: 
It looks like this. 
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Chapter 1 


Introduction 





Figure 1-1 
Removing ihe cover 


Warning 





This first chapter introduces you to the Apple Ile itself. It shows you 
what the inside looks like, identifies the main components that make 
up the machine, and tells you where to find information about each 


Removing the cover 


Remove the cover of the Apple Ile by pulling up on the back edge 
until the fasteners on either side pop loose, then move the cover an 
inch or so toward the rear of the machine to free the front of the 
cover, as shown in Figure 1-1. What you will see is shown in 

Figure 1-2. 






























































Figure 1-2 
Apple lle with the cover off 


There Is a red LED (light-emitting diode) inside the Apple lle, in 


the left rear corner of the circuit board. If the LED is on, it means 
that the power Is on and you must turn It off before you insert 
or remove anything. To avoid damaging the Apple lle, don’t 
even think of changing anything inside it without first turning off 
the power. 
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ASCII stands for American 
Standard Code for Information 
Interchange. 


Extended keyboard Ile 


The keyboard 


The keyboard is the primary input device for the Apple Ile. As 
shown in Figure 1-3 it has a normal typewriter layout, uppercase and 
lowercase, with all of the special characters in the ASCII character 
set. The keyboard is fully integrated into the machine; its operation 
is described in the first part of Chapter 2. Firmware subroutines for 
reading the keyboard are described in Chapter 3. 


The extended keyboard lle keyboard is laid out differently from 
the original and enhanced Ile keyboards, and includes an 18- 
key numeric keypad. The extended keyboard Ile keyboard is 
shown In Figure 1-4. 





Figure 1-3 
Original and enhanced Ile keyboard 





Figure 1-4 
Extended keyboard lle keyboard 
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The speaker 


The Apple Ie has a small loudspeaker in the bottom of the case. 
The speaker enables Apple Ile programs to produce a variety of 
sounds that make the programs more useful and interesting. The 
way programs control the speaker is described in Chapter 2. 


The power supply 


The power supply is inside the flat metal box along the left side of 
the interior of the Apple Ile. It provides power for the main board 
and for any peripheral cards installed in the Apple Ile. 


The power supply produces four voltages: +5V, —5V, +12V, and 
-12V. It is a high-efficiency switching supply; it includes special 
circuits that protect it and the rest of the Apple Ile against short 
circuits and other mishaps. Complete specifications of the 
Apple Ile power supply appear in Chapter 7. 


Warning The power switch and the socket for the power cord are 
mounted directly on the back of the power supply’s metal 
case. This mounting ensures that all the circuits that carry 
dangerous voltages are Inside the power supply. Do not defeat 
this design feature by attempting to open the power supply. 


The circuit board 


All the electronic parts of the Apple Ile are attached to the circuit 
board, which is mounted flat in the bottom of the case. 


Figure 1-5 shows the main integrated circuits (ICs) in the original 
and enhanced Apple Ile’s. They are the central processing unit 
(CPU), the keyboard encoder, the keyboard read-only memory 
(ROM), the two interpreter ROMs, the video ROM, and the custom 
integrated circuits: the Input Output Unit COU), the Memory 
Management Unit (MMU), and the Programmed Array Logic (PAL) 
device. 
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Extended keyboard Ile The extended keyboard Ile circuit board layout is much the 
same as that shown in Figure 1-5. However, the two Interpreter 
ROMs (CD ROM and EF ROM) have been replaced by a single 


ROM. and the eight RAM ICs have been replaced by two RAM 
ICs. 
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Figure 1-5 
Circuit board 
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The CPU used by both the enhanced Ile and the extended 
keyboard Ile is the 65C02 microprocessor. The 65C02 is an 8-bit 
microprocessor with a 16-bit address bus. The 65C02 runs at 

1.02 MHz and performs up to 500,000 8-bit operations per second. 
The specifications for the 65C02 are given in Appendix A. 


The original version of the Apple Ile uses the 6502 microprocessor. 
You can tell which version of Apple Ile you have by starting up your 
machine. An original Apple Ile displays “Apple ] [” at the top of 
the screen during startup, while the enhanced and the extended 
keyboard Apple Ile’s display “Apple //e”. This manual will call 
out specific areas where the three versions of the Apple Ile differ. 


Original Ile The original lle uses the 6502 microprocessor. The 6502 Is very 
similar to the 65C02, except that It lacks ten Instructions and 
two addressing modes found in the 65C02. In addition, the 6502 
is an NMOS device, which means Its power consumption Is 
higher than the CMOS 65C02. Except for these differences, and 
some minor differences in the number of clock cycles required 
for execution of some instructions, the 6502 and 65C02 are 
identical. 


The keyboard is decoded by an AY-3600-PRO or 9600-PRO 
integrated circuit and a read-only memory (ROM). These devices 
are described in Chapter 7. 


The interpreter ROMs (or ROM, in the case of the extended 
keyboard Ile) are integrated circuits that contain the Applesoft 
BASIC interpreter. The ROMs are described in Chapter 7. The 
Applesoft language is described in the Applesoft Tutorial and the 
Applesoft BASIC Programmer's Reference Manual. 


Two of the large ICs are custom-made for the Apple Ile: the MMU 
and the IOU. The MMU IC contains most of the logic that controls 
memory addressing in the Apple Ile. The organization of the 
memory is described in Chapter 4; the circuitry in the MMU itself is 
described in Chapter 7. 


The IOU IC contains most of the logic that controls the built-in 
input/output features of the Apple Ile. These features are described 
in Chapter 2 and Chapter 3; the IOU circuits are described in 
Chapter 7. 
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Connectors on the circuit board 


The seven slots lined up along the back of the Apple Ile circuit 
board are the expansion slots, sometimes called peripheral slots. 
(See Figure 1-6.) These slots make it possible to attach additional 
hardware to the Apple Ile. Chapter 6 tells you how your programs 
deal with the devices that plug into these slots; Chapter 7 describes 
the circuitry for the slots themselves. 








Figure 1-6 
Expansion slots 


The large slot next to the left side of the circuit board is the auxiliary 
slot (Figure 1-7). If your Apple Ile has an auxiliary memory card or 
80-Column Text Card, it will be installed in this slot. The Apple Ie 
use this slot for the Extended 80-Column Text Card. Chapter 2 
describes the 80-column display feature. The hardware and 
firmware interfaces to either type of card are described in 

Chapter 7. 


There are also smaller connectors for game I/O and for an internal 
RF (radio frequency) modulator. These connectors are described in 
Chapter 7. 





Figure 1-7 
Auxiliary slot 
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Connectors on the back panel 


The back of the Apple Ile has two miniature phone jacks for 
connecting a cassette recorder: an RCA-type jack for a video 
monitor, and a 9-pin D-type miniature connector for the hand 
controls, as shown in Figure 1-8. In addition to these, there are 
spaces for additional connectors used with the peripheral cards 
installed in the Apple Ile. The installation manuals for the 
peripheral cards contain instructions for installing the peripheral 


connectors. 





Figure 1-8 
Back panel connectors 
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Chapter 2 


Built-in |/O 
Devices 


For descriptions of the built-in 
/O hardware, refer to 
Chapter 7. 


Built-in |/O firmware routines are 
described in Chapter 3. 


This chapter describes the input and output (I/O) devices built into 
the Apple Ile in terms of their functions and the way they are used b 
programs. The built-in I/O devices are 


the keyboard 
the video-display generator 


O 

oO 

O the speaker 
O the cassette input and output 
o 


the game input and output 


At the lowest level, programs use the built-in I/O devices by reading 
and writing to dedicated memory locations. This chapter lists these 
locations for each I/O device. It also gives the locations of the 
internal soft switches that select the different display modes of the 
Apple Ile. 


“~ Built-in I/O routines: This method of input and 
output—loading and storing directly to specific locations in 
memory—is not the only method you can use. For many of 
your programs, it may be more convenient to call the built-in 
I/O routines stored in the Apple IIe’s firmware. 


The keyboard 


The primary built-in input device for the Apple Ile is the keyboard. 
The original and enhanced Ile keyboards have 63 keys, while the 
extended keyboard Ile keyboard has 81 keys. Both keyboard types 
have automatic repeat, which means that if you press any key longer 
than you would during normal typing, the character code for that 
key will be sent continuously until you release the key. Both 
keyboard types also allow you to hold down any number of keys and 
still press another key; this is known as N-key rollover. 


The keyboard layout shown in Figure 2-1 is for the original and 
enhanced Ile keyboards. The keyboard layout shown in Figure 2-2 is 
for the extended keyboard Ile keyboard. 


Apple Ile’s manufactured for sale outside the United States have a 
slightly different standard keyboard arrangement and include 
provisions for switching between different character sets. These 
differences are described in Appendix I. 
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Figure 2-1 
Original and enhanced Ile keyboard 
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Figure 2-2 
Extended keyboard Ile keyboard 
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In addition to the keys normally used for typing characters, there 
are four cursor-control keys with arrows: left, right, down, and up. 
The cursor-control keys can be read the same as other keys; their 
codes are $08, $15, $0A, and $0B. (See Table 2-2.) 


Three special keys—Control, Shift, and Caps Lock—change the 
codes generated by the other keys. The Control key is similar to the 
ASCII CTRL key. 


Three other keys have special functions: the Reset key, and two keys 
marked with apples, one outlined (Open Apple) and one solid 
(Solid Apple). Pressing the Reset key with the Control key depressed 
resets the Apple Ile, as described in Chapter 4. The Apple keys are 
connected to the one-bit game inputs, described later in this 
chapter. 
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Extended keyboard Ile 


See Chapter 7 for a complete 
description of the electrical 
interface to the keyboard. 


Hexadecimal refers to the base- 
16 number system, which uses 
the digits 0 through 9 and the six 
letters A through F to represent 
values from 10 to 15. 


On the extended keyboard lle the Solid Apple key is labeled 


Option; the Solid Apple and Option keys are functionally 
identical. Also note that manuals accompanying products with 
the Solid Apple labeled as Option may refer to the Open Apple 
key as simply the Apple key. 


The electrical interface between the Apple Ile and the keyboard is a 
ribbon cable with a 26-pin connector. This cable carries the 
keyboard signals to the encoding circuitry on the main board. 


Reading the keyboard 


The keyboard encoder and ROM generate all 128 ASCII codes, so all 
the special character codes in the ASCII character set are available 
from the keyboard. Machine-language programs obtain character 
codes from the keyboard by reading a byte from the keyboard-data 
location shown in Table 2-1. 


Table 2-1 

Keyboard memory locations 
Location 

Hex Decimal Description 


$C000 49152-16384 Keyboard data and strobe 
$C010 49168 -16368 Any-key-down flag and clear-strobe switch 


Your programs can get the code for the last key pressed by reading 
the keyboard-data location. Table 2-1 gives this location in three 
different forms: the hexadecimal value used in assembly language, 
indicated by a preceding dollar sign ($); the decimal value used in 
Applesoft BASIC; and the complementary decimal value used in 
Apple Integer BASIC. (integer BASIC requires that values greater 
than 32,767 be written as the number obtained by subtracting 65,536 
from the value. These are the decimal numbers shown as negative in 
tables in this manual; refer to the Apple II BASIC Programming 
Manual.) The low-order seven bits of the byte at the keyboard 
location contain the character code; the high-order bit of this byte 
is the strobe bit, described below. 
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Extended keyboard Ile 


Important 


Your program can find out whether any key is down, except the 
Reset, Control, Shift, Caps Lock, Open Apple, and Solid Apple (or 
Option, on the extended keyboard Ile) keys, by reading from 
location 49152 (hexadecimal $C000 or complementary decimal 
~16384). The high-order bit (bit 7) of the byte you read at this 
location is called any-key-dowm; it is 1 if a key is down, and 0 if no 
key is down. The value of this bit is 128; if a BASIC program gets this 
information with a PEEK, the value is 128 or greater if any key is 
down, and less than 128 if no key is down. 


The Open Apple and Solid Apple keys are connected to switches 0 
and 1 of the game I/O connector inputs. If OA is pressed, switch 0 is 
“pressed,” and if Solid Apple is pressed, switch 1 is “pressed.” 


On the extended keyboard lle, the Shift key is connected to 
switch 2 of the game I/O ports via the X6 jumper (single-wire 
Shift-key mod jumper). 


The strobe bit is the high-order bit of the keyboard-data byte. After 


any key has been pressed, the strobe bit is high. It remains high 
until you reset it by reading or writing at the clear-strobe location. 
This location is a combination flag and switch; the flag tells whether 
any key is down, and the switch clears the strobe bit. The switch 
function of this memory location is called a soft switch because it is 
controlled by software. In this case, it doesn’t matter whether the 
program reads or writes, and it doesn’t matter what data the 
program writes: the only action that occurs is the resetting of the 
keyboard strobe. Similar soft switches, described later, are used for 
controlling other functions in the Apple Ile. 


Any time you read the any-key-down flag, you also clear the 


keyboard strobe. If your program needs to read both the flag 
and the strobe, it must read the strobe bit first. 


After the keyboard strobe has been cleared, it remains low until 
another key is pressed. Even after you have cleared the strobe, you 
can still read the character code at the keyboard location. The data 
byte has a different value, because the high-order bit is no longer 
set, but the ASCII code in the seven low-order bits is the same until 
another key is pressed. Table 2-2 shows the ASCII codes for most of 
the keys on the keyboard of the Apple Ile. 
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Extended keyboard Ile 


The reset routine is described in 


Chapter 4. 


Extended keyboard Ile 


Table 2-2 


Keys and ASCII codes 


Key 


Delete 

Left Arrow 
Tab 

Down Arrow 
Up Arrow 
Return 

Right Arrow 
Escape 
Space 


< 


Normal 


Code 


There are several special-function keys that do not generate ASCII 
codes. For example, you cannot read the Control, Shift, and Caps 
Lock keys directly, but pressing one of these keys alters the character 
codes produced by the other keys. 


As a result of the single-wire Shift-key mod, the Shift key can be 
read directly in the extended keyboard lle. 


Another key that doesn’t generate a code is Reset, located at the 
upper-right corner of the keyboard; it is connected directly to the 
Apple Ile’s circuits. Pressing Reset with Control depressed normally 
causes the system to stop whatever program it’s running and restart 
itself. This restarting process is called the reset routine. 


Two more special keys are the Apple keys, Open Apple and Solid 
Apple, located on either side of the Space bar. These keys are 
connected to the one-bit game inputs, which are. described later in 
this chapter in the section “Switch Inputs.” Pressing them in 
combination with the Control and Reset keys causes the built-in 
firmware to perform special reset and self-test cycles, described 
with the reset routine in Chapter 4. 


The Open Apple and Option keys are both located on the left 
side of the Space bar on the extended keyboard Ile, See 
Figure 2-2 for a diagram of the keyboard layout for the 
extended keyboard lle. 


Control Shift Both 
Char Code Char Code Char Code Char 
DEL TF DEL 7F DEL 7F DEL 
08 BS 08 BS 08 BS 
09 HT 09 HT 09 HT 
0A LF OA LF 0A LF 
OB VT 0B VT OB VT 
0D CR oD CR 0D CR 
NAK 15 NAK 15 NAK 15 NAK 
ESC 1B ESC 1B ESC 1B ESC 
20 SP 20 SP 20 SP 
27 ' 22 " 22 # 
2C ; 3C < 3C < 
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Table 2-2 (continued) 
Keys and ASCIll codes 


Normal Control Shift Both 
_Key Code Char Code Char Code Char Code Char 
-_ 2D - 1F US 5F 4 1F US 
2 2E ‘ 2E P 3E > 3E > 
jf? 2F / 2F i 3F 2 3F ? 
0) 30 0 30 0 29 ) 29 ) 
1! 31 1 31 1 21 ! 21 ! 
2@ 32 2 00 NUL 40 @ 00 NUL 
3# 33 3 33 3 23 # 23 # 
4$ 34 4 34 4 24 $ 24 $ 
5% 35 5 35 5 25 % 25 % 
6A 36 6 1E RS 5E A 1E RS 
7& 37 7 37 7 26 & 26 & 
8 * 38 8 38 8 2A ‘ 2A : 
9¢ 39 9 39 9 28 ¢ 28 ¢ 
; 3B - 3B : 3A 3A : 
= + 3D = 3D = 2B + 2B + 
{{ 5B [ 1B ESC 7B { 1B ESC 
\ | 5C \ 1C FS LG | 1C FS 
1} 5D ] 1D GS 7D } 1D GS 
~ 60 ; 60 5 JE ~ JE ~ 
A 61 a 01 SOH 41 A 01 SOH 
B 62 b 02 STX 42 B 02 STX 
Cc 63 c 03 ETX 43 Cc 03 ETX 
D 64 d 04 EOT 44 D 04 EOT 
E 65 e 05 ENQ 45 E 05 ENQ 
F 66 f 06 ACK 46 F 06 ACK 
G 67 8 07 BEL 47 G 07 BEL 
H 68 h 08 BS 48 H 08 BS - 
I 69 i 09 HT 49 I 09 HT 
J 6A j 0A LF 4A J OA IF 
K 6B k OB VT 4B K OB VT 
L 6C 1 0c FF 4C L 0c FF 
M 6D m 0D CR 4D M 0D CR 
N ; 6E n OE SO 4E N OE SO 
O 6F re) OF SI 4F O OF SI 
P 70 Pp 10 DLE 50 P 10 DLE 
Q 71 q 11 DCl 51 Q 11 DCc1 
R 72 r 12 DC2 52 R 12 DC2 
S 73 s 13 DC3 53 S 13 DC3 
T 74 t 14 DC4 54 pi 14 DC4 
U 75 u 15 NAK 55 U 15 NAK 
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Table 2-2 (continued) 
Keys and ASCil codes 


Key 


NX x d¢< 


Normal Control Shift Both 
Code Char Code Char Code Char Code Char 
76 Vv 16 SYN 56 Vv 16 SYN 
77 w 17 ETB 57 WwW 17 ETB 
78 x 18 CAN 58 x 18 CAN 
79 y 19 EM 59 Y 19 EM 
7A Z 1A SUB 5A Z 


1A SUB 


Note: Codes are shown here in hexadecimal; to find the decimal equivalents, refer to Table E-3. 
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Extended keyboard Ile 


Important 


The ASCIl codes generated by the numeric keypad on the 
extended keyboard Ile are the same as those for the 
corresponding characters on the main keyboard. See Table 2-2. 


The video display generator 


The primary output device of the Apple Ue is the video display. You 
can use any ordinary video monitor, either color or black-and- 
white, to display video information from the Apple Tle. An 
ordinary monitor is one that accepts composite video compatible 
with the standard set by the NTSC (National Television Standards 
Committee). If you use Apple Ile color graphics with a 
monochrome (single-color) monitor, the display will appear as 
that color (black, for example) and various patterns made up of 
shades of that color. 


If you are using only 40-column text and graphics modes, you can 
use a television set for your video display. If the TV set has an input 
connector for composite video, you can connect it directly to your 
Apple Ile; if it does not, you’ll need to attach a radio frequency (RF) 
video modulator between the Apple Ile and the television set. 


With the 80-column text card installed, the Apple fle can 
produce an 80-column text display. However, if you use an 
ordinary color or black-and-white television set, 80-column text” 
will be too blurry to read. For a clear 80-column display, you 
must use a high-resolution video monitor with a bandwidth of 

14 MHz or greater. 
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Original lle 


For a full description of the video 
signal and the connections to 
the Molex-type pins, refer to the 
section “Video Output Signals” 
in Chapter 7. 


The specifications for the video display are summarized in 
Table 2-3. 


Note that MouseText characters are not Included in the 
original version of the Apple lle. 


The video signal produced by the Apple Ile is NTSC-compatible 
composite color video. It is available at three places: the RCA-type 
phono jack on the back of the Apple Ile, the single Molex-type pin 
on the main circuit board near the back on the right side, and one 
of the group of four Molex-type pins in the same area on the main 
board. Use the RCA-type phono jack to connect a video monitor or 
an external video modulator; use the Molex pins to connect the 
type of video modulator that fits inside the Apple Ie case. 


Table 2-3 : 
Video display specifications 


Display modes 40-column text; map: Figure 2-3 
80-column text; map: Figure 2-4 
Low-resolution color graphics; map: Figure 2-8 
High-resolution color graphics; map: Figure 2-9 
Double high-res color graphics, map: Figure 2-10 


Text capacity 24 lines by 80 columns (character positions) 
Character set 96 ASCII characters (uppercase and lowercase) 
Display formats Normal, inverse, flashing, MouseText (Table 2-4) 


Low-resolution 16 colors (Table 2-5), 40 horizontal by 48 vertical; 
graphics map: Figure 2-8 


High-resolution 6 colors (Table 2-6), 140 horizontal by 192 vertical 
graphics (restricted) 
Black-and-white: 280 horizontal by 192 vertical; 


map: Figure 2-9 
Double 16 colors (Table 2-7), 140 horizontal by 192 
high-resolution —_vertical (no restrictions) 
graphics Black-and-white: 560 horizontal by 192 vertical, 


map: Figure 2-10 
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The Apple Ile can produce seven different kinds of video display: 

text, 24 lines of 40 characters 

text, 24 lines of 80 characters (with optional text card) 

low-resolution graphics, 40 by 48, in 16 colors 

high-resolution graphics, 140 by 192, in 6 colors 

high-resolution graphics, 280 by 192, in black and white 

double high-resolution graphics, 140 by 192, in 16 colors (with 

optional 64K text card) 

oO double high-resolution graphics, 560 by 192, in black and white 
(with optional 64K text card) 


The 2 text modes can display all 96 ASCII characters: uppercase and 
lowercase letters, numbers, and symbols. The enhanced and 
extended keyboard Apple Ile’s can also display MouseText 
characters. 


co 


Any of the graphics displays can have four lines of text at the bottom 
of the screen. The text may be either 40-column or 80-column, 
except that double high-resolution graphics may only have 80- 
column text at the bottom of the screen. Graphics displays with text 
at the bottom are called mixed-mode displays. 


The low-resolution graphics display is an array of colored blocks, 
40 wide by 48 high, in any of 16 colors. In mixed mode, the four 
lines of text replace the bottom eight rows of blocks, leaving 40 rows 
of 40 blocks each. 


The high-resolution graphics display is an array of dots, 280 wide by 
192 high. There are six colors available in high-resolution displays, 
but a given dot can use only four of the six colors. If color is used, 
the display is 140 dots wide by 192 high. In mixed mode, the 4 lines 
of text replace the bottom 32 rows of dots, leaving 160 rows of 280 
dots each. 


The double high-resolution graphics display uses main and 
auxiliary memory to display an array of dots, 560 wide by 192 high. 
All the dots are visible in black and white. If color is used, the - 
display is 140 dots wide by 192 high with 16 colors available. In 
mixed mode, the 4 lines of text replace the bottom 32 rows of dots, 
leaving 160 rows of 560 (or 140) dots each. In mixed mode, the text 
lines can be 80 columns wide only. 
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Text modes 


The text characters displayed include the uppercase and lowercase 
letters, the ten digits, punctuation marks, and special characters. 
Each character is displayed in an area of the screen that is seven 
dots wide by eight dots high. The characters are formed by a dot 
matrix five dots wide, leaving two blank columns of dots between 
characters in a row, except for MouseText characters, some of 
which are seven dots wide. Except for lowercase letters with 
descenders and some MouseText characters, the characters are 
only seven dots high, leaving one blank line of dots between rows of 
characters. 


The normal display has white (or other single color) dots on a black 
background. Characters can also be displayed as black dots on a 
white background; this is called inverse format. 


Text character sets 


The Apple Ile can display either of two text character sets: the 
primary set or an alternate set. The forms of the characters in the 
two sets are actually the same, but the available display formats are 
different. The display formats are 


O normal, with white dots on a black screen 
O inverse, with black dots on a white screen 


O flashing, alternating between normal and inverse 


With the primary character set, the Apple IIe can display uppercase 
characters in all three formats: normal, inverse, and flashing. 
Lowercase letters can only be displayed in normal format. The 
primary character set is compatible with most software written for 
the Apple II and Apple II Plus models, which can display text in 
flashing format but don’t have lowercase characters. 


The alternate character set displays characters in either normal or 
inverse format. In normal format, you can get 


O uppercase letters 

QO lowercase letters 

CO numbers 

Q special characters 

In inverse format, you can get 


© MouseText characters (on the enhanced and extended keyboard 
Ile’s) 
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O uppercase letters 
O lowercase letters 
O numbers 


0 special characters 


The MouseText characters that replace the alternate uppercase 
inverse characters in the range of $40-$5F in the original Apple Ile 
are inverse characters, but they don’t look like it because of the way 
they have been constructed. 


You select the character set by means of the alternate-text soft 
switch, ALTCHAR, described later in the section “Display Mode 
Switching.” Table 2-4 shows the character codes in hexadecimal for 
the Apple Ile primary and alternate character sets in normal, 
inverse, and flashing formats. 


Each character on the screen is stored as one byte of display data. 
The low-order six bits make up the ASCII code of the character 
being displayed. The remaining two (high-order) bits select inverse 
or flashing format and uppercase or lowercase characters. In the 
primary character set, bit 7 selects inverse or normal format and 
bit 6 controls character flashing. In the alternate character set, bit 6 
selects between uppercase and lowercase, according to the ASCII 
character codes, and flashing format is not available. 


Table 2-4 
Display character sets 

Primary character set Alternate character set 
Hex SSS a 
values Character type Format Character type Format 
$00-$1F Uppercase letters Inverse Uppercase letters Inverse 
$20-$3F Special characters Inverse Special characters Inverse 
$40-$5F Uppercase letters Flashing MouseText Inverse 
$60-$7F Special characters _ Flashing Lowercase letters Inverse 
$80-$9F Uppercase letters Normal Uppercase letters Normal 
$A0-$ BF Special characters Normal Special characters Normal 
$CO-$DF Uppercase letters Normal Uppercase letters Normal 
$E0-$FF Lowercase letters Normal Lowercase letters Normal 


Note: To identify particular characters and values, refer to Table 2-2. 


Original lle In the alternate character set of the original Apple lle, 
characters in the range $40-$5F are uppercase inverse. 
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40-column versus 80-column text 


The Apple He has two modes of text display: 40-column and 80- 
column. (The 80-column display mode described in this manual is 
the one you get with the Apple Ile 80-Column Text Card or other 
auxiliary-memory card installed in the auxiliary slot.) The number 
of dots in each character does not change, but the characters in 80- 
column mode are only half as wide as the characters in 40-column 
mode. Compare Figure 2-3 and Figure 2-4. On an ordinary color or 
black-and-white television set, the narrow characters in the 80- 
column display blur together; you must use the 40-column mode to 
display text on a television set. 


Graphics modes 


The Apple Ile can produce video graphics in three different modes. 
All the graphics modes treat the screen as a rectangular array of 
spots. Normally, your programs will use the features of some high- 
level language to draw graphics dots, lines, and shapes in these 
arrays; this section describes the way the resulting graphics data are 
stored in the Apple Ile’s memory. 


Low-resolution graphics 


In the low-resolution graphics mode, the Apple Ile displays an 
array of 48 rows by 40 columns of colored blocks. Each block can be 
any one of sixteen colors, including black and white. On a black- 
and-white monitor or television set, these colors appear as black, 
white, and three shades of gray. There are no blank dots between 
blocks; adjacent blocks of the same color merge to make a larger 
shape. 


Data for the low-resolution graphics display is stored in the same 
part of memory as the data for the 40-column text display. Each 
byte contains data for two low-resolution graphics blocks. The two 
blocks are displayed one atop the other in a display space the same 
size as a 40-column text character, seven dots wide by eight dots 
high. 
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JLI 


10 
20 
30 
40 
50 
60 
70 
80 
90 
100 
150 
160 
170 
180 
190 
200 
100 
110 
] 


]LIST 0,100 


10 REM APPLESOFT CHARACTER DEMO 

20 TEXT : HOME 

30 PRINT : PRINT "Applesoft Char 
acter Demo" 

40 PRINT : PRINT "Which characte 
ry set=-" 

50 PRINT : INPUT "Primary (P) or 
Alternate (A) ?";AS 

60 IF LEN (A$) < 1 THEN 50 

65 LET AS = LEFTS (A$,1) 


70 .XIF AS = “"P™ THEN POKE 49166, 
0 

80 IF A$ = "A" THEN POKE 49167, 
0 


90 PRINT : PRINT "...printing th 
e same line, first" 

100 PRINT " in NORMAL, then INVE 
RSE ,then FLASH:": PRINT 

] 


Figure 2-3 
40-column text display 


ST 0,1100 


REM APPLESOFT CHARACTER DEMO 
TEXT :; HOME 
PRINT : PRINT "Applesoft Character Demo" 
PRINT : PRINT "Which character set--" 
PRINT : INPUT "Primary (P) or Alternate (A) ?";A$ 
IF LEN (AS) < 1 THEN 50 
LET AS = LEFTS (AS,1) 
IF AS = "P" THEN POKE 49166,0 
IF AS = "A™ THEN POKE 49167,0 

PRINT : PRINT "...printing the same line, first" 
PRINT ™ in NORMAL, then INVERSE ,then FLASH:": PRINT 
NORMAL : GOSUB 1000 

INVERSE : GOSUB 1000 

FLASH : GOSUB 1000 

NORMAL : PRINT : PRINT : PRINT "Press any key to repeat." GET A$ 
GOTO 10 
O PRINT : PRINT "SAMPLE TEXT: Now is the time--12:00" 
O RETURN 


Figure 2-4 
80-column text display 
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Low-resolution graphics colors 


Table 2-5 
Nibble value 
Dec Hex 
0 $00 
1 $01 
2 $02 
3 $03 
4 $04 
5 $05 
6 $06 
7 $07 
8 $08 
9 $09 
10 $OA 
11 $0B 
12 $0C 
13 $0D 
14 $0E 
15 $0F 


Color 


Black 
Magenta 
Dark blue 
Purple 

Dark green 
Gray 
Medium blue 
Light blue 
Brown 
Orange 
Gray 2 

Pink 

Light green 
Yellow 
Aquamarine 
White 


Note: Colors may vary, depending 
upon the controls on the monitor or 


TV set. 


Bits in Data Byte 





Figure 2-5 


Dots on Graphics Screen 


High-resolution display bits 


Half a byte—four bits, or one nibble—is assigned to each graphics 
block. Each nibble can have a value from 0 to 15, and this value 
determines which one of 16 colors appears on the screen. The 
colors and their corresponding nibble values are shown in 

Table 2-5. In each byte, the low-order nibble sets the color for the 
top block of the pair, and the high-order nibble sets the color for 
the bottom block. Thus, a byte containing the hexadecimal value 
$D8 produces a brown block atop a yellow block on the screen. 


As explained later in the section “Video Display Pages,” the text 
display and the low-resolution graphics display use the same area in 
memory. Most programs that generate text and graphics clear this 
part of memory when they change display modes, but it is possible 
to store data as text and display it as graphics, or vice-versa. All you 
have to do is change the mode switch, described later in this 
chapter in the section “Display Mode Switching,” without changing 
the display data. This usually produces meaningless jumbles on the 
display, but some programs have used this technique to good 
advantage for producing complex low-resolution graphics displays 
quickly. 


High-resolution graphics 


In the high-resolution graphics mode, the Apple Ile displays an 
array of colored dots in 192 rows and 280 columns. The colors 
available are black, white, purple, green, orange, and blue, 
although the colors of the individual dots are limited, as described 
later in this section. Adjacent dots of the same color merge to form 
a larger colored area. 


Data for the high-resolution graphics displays are stored in either of 
two 8192-byte areas in memory. These areas are called high- 
resolution Page 1 and Page 2; think of them as buffers where you 
can put data to be displayed. Normally, your programs will use the 
features of some high-level language to draw graphics dots, lines, 
and shapes to display; this section describes the way the resulting 
graphics data are stored in the Apple Ile’s memory. 


The Apple Ile high-resolution graphics display is bit-mapped: each 
dot on the screen corresponds to a bit in the Apple Ile’s memory. 
The seven low-order bits of each display byte control a row of seven 
adjacent dots on the screen, and forty adjacent bytes in memory 
control a row of 280 (7 times 40) dots. The least significant bit of 
each byte is displayed as the leftmost dot in a row of seven, followed 
by the second-least significant bit, and so on, as shown in 

Figure 2-5. The eighth bit (the most significant) of each byte is not 
displayed, it selects one of two color sets, as described later. 
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For more details about the way 
the Apple lle produces color on a 
TV set, see the section “Video 
Display Modes” in Chapter 7. 


On a black-and-white monitor, there is a simple correspondence 
between bits in memory and dots on the screen. A dot is white if the 
bit controlling it is on (1), and the dot is black if the bit is off (0). On 
a black-and-white television set, pairs of dots blur together; 
alternating black and white dots merge to a continuous gray. 


On an NTSC color monitor or a color television set, a dot whose 
controlling bit is off (0) is black. If the bit is on, the dot will be white 
or a color, depending on its position, the dots on either side, and 
the setting of the high-order bit of the byte. 


Call the left-most column of dots column zero, and assume (for the 
moment) that the high-order bits of all the data bytes are off (0). If 
the bits that control dots in even-numbered columns (0, 2, 4, and 
so forth) are on, the dots are purple; if the bits that control odd- 
numbered columns are on, the dots are green—but only if the dots 
on both sides of a given dot are black. If two adjacent dots are both 
on, they are both white. 


You select the other two colors, blue and orange, by turning the 
high-order bit (bit 7) of a data byte on (1). The colored dots 
controlled by a byte with the high-order bit on are either blue or 
orange: the dots in even-numbered columns are blue, and the dots 
in odd-numbered columns are orange—again, only if the dots on 
both sides are black. Within éach horizontal line of seven dots 
controlled by a single byte, you can have black, white, and one pair 
of colors. To change the color of any dot to one of the other pair of 
colors, you must change the high-order bit of its byte, which affects 
the colors of all seven dots controlled by the byte. 


In other words, high-resolution graphics displayed on a color 
monitor or television set are made up of colored dots, according to 
the following rules: 


O Dots in even columns can be black, purple, or blue. 
0 Dots in odd columns can be black, green, or orange. 
0 If adjacent dots in a row are both on, they are both white. 


O The colors in each row of seven dots controlled by a single byte 
are either purple and green, or blue and orange, depending on 
whether the high-order bit is off (0) or on (1). 
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For information about the way 
NTSC color television works, see 
the magazine articles listed in 
the bibliography. 


These rules are summarized in Table 2-6. The blacks and whites are 
numbered to remind you that the high-order bit is different. 


Table 2-6 
High-resolution graphics colors 


Bits 0-6 Bit 7 off Bit 7 on 


Adjacent columns off Black 1 Black 2 
Even columns on Purple Blue 

Odd columns on Green Orange 
Adjacent columns on White 1 White 2 


Note: Colors may vary depending upon the 
controls on the monitor or television set. 


The peculiar behavior of the high-resolution colors reflects the way 
NTSC color television works. The dots that make up the Apple Ile 
video signal are spaced to coincide with the frequency of the color 
subcarrier used in the NTSC system. Alternating black and white 
dots at this spacing cause a color monitor or TV set to produce 
color, but two or more white dots together do not. Effective 
horizontal resolution with color is 140 dots per line (280 divided 
by 2). 


Double high-resolution graphics 


In the double high-resolution graphics mode, the Apple IIe 
displays an array of colored dots 560 columns wide and 192 rows 
deep. There are 16 colors available for use with double high- 
resolution graphics (see Table 2-7). 


Double high-resolution graphics is a bit-mapping of the low-order 
seven bits of the bytes in the main-memory and auxiliary-memory 
pages at $2000-$3FFF. The bytes in the main-memory and 
auxiliary-memory pages are interleaved in exactly the same manner 
as the characters in 80-column text: of each pair of identical 
addresses, the auxiliary-memory byte is displayed first, and the 
main-memory byte is displayed second. Horizontal resolution is 
560 dots when displayed on a monochrome monitor. 
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Unlike high-resolution color, double high-resolution color has no 
restrictions on which colors can be adjacent. Color is determined 
by any four adjacent dots along a line. Think of a four-dot-wide 
window moving across the screen: at any given time, the color 
displayed will correspond to the four-bit value from Table 2-7 that 
corresponds to the window’s position (Figure 2-10). Effective 
horizontal resolution with color is 140 (560 divided by 4) dots per 
line. 


To use Table 2-7, divide the display column number by four, and 
use the remainder to find the correct column in the table: @b0 is a 
byte residing in auxiliary memory corresponding to a remainder 
of zero (byte 0, 4, 8, and so on); mb1 is a byte residing in main 
memory corresponding to a remainder of one (byte 1, 5, 9, and so 
on); and similarly for ab3 and mb4. 


Table 2-7 
Double high-resolution graphics colors 

Repeated 
Color abd mb1 ab2 mb3 bit pattern 
Black $00 $00 $00 $00 0000 
Magenta $08 $11 $22 $44 0001 
Brown $44 $08 $11 $22 0010 
Orange $4C $19 $33 $66 0011 
Dark green $22 $44 $08 $11 0100 
Gray 1 $2A $55 $2A $55 0101 
Green $66 $4C $19 $33 0110 
Yellow $6E $5D $3B $77 0111 
Dark blue $11 $22 $44 $08 1000 
Purple $19 $33 $66 $4C 1001 
Gray 2 $55 $2A $55 $2A 1010 
Pink $5D $3B $77 $6E 1011 
Medium blue $33 $66 $4C $19 1100 
Light blue $3B $77 $6E $5D 1101 
Aqua $77 $6E $5D $3B 1110 
White $7F $7F $7F $7F 1111 
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Video display pages 


The Apple Ie generates its video displays using data stored in 
specific areas in memory. These areas, called display pages, serve 
as buffers where your programs can put data to be displayed. Each 
byte in a display buffer controls an object at a certain location on 
the display. In text mode, the object is a single character, in low- 
resolution graphics, the object is two stacked colored blocks; and in 
high-resolution and double high-resolution modes, it is a line of 
seven adjacent dots. 


The 40-column-text and low-resolution-graphics modes use two 
display pages of 1024 bytes each. These are called text Page 1 and 
text Page 2, and they are located at 1024-2047 (hexadecimal 
$0400-$07FF) and 2048-3071 ($0800-$0BFF) in main memory. 
Normally, only Page 1 is used, but you can put text or graphics data 
into Page 2 and switch displays instantly. Either page can be 
displayed as 40-column text, low-resolution graphics, or mixed 
mode (four rows of text at the bottom of a graphics display). 


The 80-column text mode displays twice as much data as the 40- 
column mode—1920 bytes—but it cannot switch pages. The 80- 
column text display uses a combination page made up of text Page 1 
in main memory plus another page in auxiliary memory located on 
the 80-column text card. This additional memory is not the same as 
text Page 2—in fact, it occupies the same address space as text 

Page 1, and there is a special soft switch that enables you to store 
data into it. (See the next section, “Display Mode Switching.”) The 
built-in firmware I/O routines, described in Chapter 3, take care of 
this extra addressing automatically; that is one reason to use those 
routines for all your normal text output. 


The high-resolution graphics mode also has two display pages, but 
each page is 8192 bytes long. In the 40-column text and low- 
resolution graphics modes each byte controls a display area seven 
dots wide by eight dots high. In high-resolution graphics mode 
each byte controls an area seven dots wide by one dot high. Thus, a 
high-resolution display requires eight times as much data storage, 
as shown in Table 2-8. 


The double high-resolution graphics mode uses high-resolution 
Page 1 in both main and auxiliary memory. Each byte in those 
pages of memory controls a display area seven dots wide by one dot 
high. This gives you 560 dots per line in black and white, and 140 
dots per line in color. A double high-resolution display requires 
twice the total memory as high-resolution graphics, and 16 times as 
much as a low-resolution display. 
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Table 2-8 
Video display page locations 


Lowest address Highest address 
Display SS ae Laat on 
Display mode page Hex Dec Hex Dec 
40-column text, 1 $0400 1024 $O7FF 2047 
low-resolution 2* $0800 2048 $OBFF 3071 
graphics 
80-column text 1 $0400 1024 $07FF 2047 
2* $0800 2048 $OBFF 3071 
High-resolution 1 $2000 8192 $3FFF 16383 
graphics 2 $4000 16384 $SFFF 24575 
Double high- 1t $2000 8192 $3FFF 16383 
resolution 2t $4000 16384 $SFFF 24575 
graphics 


* This is not supported by firmware; for instructions on how to switch 
pages, refer to the next section, “Display Mode Switching.” 

+ See the section “Double High-Resolution Graphics” earlier in this 
chapter. 


Display mode switching 


You select the display mode that is appropriate for your application 
by reading or writing to a reserved memory location called a soft 
switch. In the Apple Ile, most soft switches have three memory 
locations reserved for them: one for turning the switch on, one for 
turning it off, and one for reading the current state of the switch. 


Table 2-9 shows the reserved locations for the soft switches that 
control the display modes. For example, to switch from mixed- 
mode to full-screen graphics in an assembly-language program, 
you could use the instruction 


STA $C052 
To do this in a BASIC program, you could use the instruction 
POKE 49234,0 


Some of the soft switches in Table 2-9 must be read, some must be 
written to, and for some you can use either action. When writing to a 
soft switch, it doesn’t matter what value you write; the action occurs 
when you address the location, and the value is ignored. 
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Table 2-9 
Display soft switches 


Name Action Hex Function 
ALTCHAR Ww $COOE Off: display text using 
primary character set 
ALTCHAR Ww $COOF On: display text using 
alternate character set 
RDALTCHAR R7 $C01E Read ALTCHAR switch 
(1 = on) 
80COL Ww $COOC Off: display 40 columns 
80COL Ww $COOD = On: display 80 columns 
RD80COL R7 $CO1F Read 80COL switch (1 = on) 
80STORE WwW $C000 Off: cause PAGE2 on to 
select auxiliary RAM 
80STORE W $C001 On: allow PAGE2 to switch 
main RAM areas 
RD80STORE R7 $Cc018 Read 80STORE switch 
C1 = on) 
PAGE2 R/W $C054 Off: select Page 1 
PAGE2 R/W $C055 On: select Page 2 or, if 


80STORE on, Page 1 in 
auxiliary memory 


RDPAGE2 R7 $C01C Read PAGE2 switch (1 = on) 

TEXT R/W $C050 Off: display graphics or, if 
MIXED on, mixed 

TEXT R/W = $C051 On: display text 

RDTEXT R7 $CO1A Read TEXT switch (1 = on) 

MIXED R/W $C052 Off: display only text or only 
graphics 

MIXED R/W = $C053 On: if TEXT off, display text 
and graphics 

RDMIXED R7 $CO1B Read MIXED switch (1 = on) 

HIRES R/W = $C056 Off: if TEXT off, display low- 


resolution graphics 
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Table 2-9 (continued) 
Display soft switches 


Name Action Hex Function 


HIRES R/W = $C057 On: if TEXT off, display 
high-resolution or, if 
DHIRES on, double high- 
resolution graphics 


RDHIRES R7 $C01D Read HIRES switch (1 = on) 


IOUDIS Ww $CO7E On: disable IOU access for 
addresses $C058 to $COS5F; 
enable access to DHIRES 
switch* 


IOUDIS Ww $CO7F Off: enable IOU access for 
addresses $C058 to $CO5F; 
disable access to DHIRES 


switch* 
RDIOUDIS R7 $CO7E Read IOUDIS switch (1 = oft 
DHIRES R/W $COSE On: if IOUDIS on, turn on 
double high resolution 
DHIRES R/W $CO5F Off: if IOUDIS on, turn off 
double high resolution 
RDDHIRES R7 $CO7F Read DHIRES switch 
(1 = ont 
VBL R7 $C091 Vertical blanking 


Note: W means write anything to the location, R means read the location, 

R/W means read or write, and R7 means read the location and check bit 7. 

* The firmware normally leaves IOUDIS on. See also j. 

+ Reading or writing any address in the range $CO70-$CO7F also triggers 
the paddle timer and resets VBLINT (Chapter 7). 


“ By the way: You may not need to deal with these functions by 
reading and writing directly to the memory locations in 
Table 2-9, Many of the functions shown here are selected 
automatically if you use the display routines in the various high- 
level languages on the Apple Ile. 
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For a full description of the way 
the Apple lle handles its display 
memory, refer to the section 
“Display Memory Addressing” in 
Chapter 7. 


Any time you read a soft switch, you get a byte of data. However, the 
only information the byte contains is the state of the switch, and this 
occupies only one bit—bit 7, the high-order bit. The other bits in 
the byte are unpredictable. If you are programming in machine 
language, the switch setting is the sign bit; as soon as you read the 
byte, you can do a Branch Plus if the switch is off, or Branch Minus 
if the switch if on. 


If you read a soft switch from a BASIC program, you get a value 
between 0 and 255. Bit 7 has a value of 128, so if the switch is on, the 
value will be equal to or greater than 128; if the switch is off, the 
value will be less than 128. 


Addressing display pages directly 


Before you decide to use the display pages directly, consider the 
alternatives. Most high-level languages enable you to write 
statements that control the text and graphics displays. Similarly, if 
you are programming in assembly language, you may be able to use 
the display features of the built-in I/O firmware. You should store 
directly into display memory only if the existing programs can’t 
meet your requirements. 


The display memory maps are shown in Figures 2-6, 2-7, 2-8, 2-9, 
and 2-10. All the different display modes use the same basic 
addressing scheme: characters or graphics bytes are stored as rows 
of 40 contiguous bytes, but the rows themselves are not stored at 
locations corresponding to their locations on the display. Instead, 
the display address is transformed so that three rows that are eight 
rows apart on the display are grouped together and stored in the 
first 120 locations of each block of 128 bytes ($80 hexadecimal). By 
folding the display data into memory this way, the Apple Ile, like 
the Apple II, stores all 960 characters of displayed text within 1K 
bytes of memory. 


The high-resolution graphics display is stored in much the same 
way as text, but there are eight times as many bytes to store, because 
eight rows of dots occupy the same space on the display as one row 
of characters. The subset consisting of all the first rows from the 
groups of eight is stored in the first 1024 bytes of the high-resolution 
display page. The subset consisting of all the second rows from the 
groups of eight is stored in the second 1024 bytes, and so on for a 
total of 8 times 1024, or 8192 bytes. In other words, each block of 
1024 bytes in the high-resolution display page contains one row of 
dots out of every group of eight rows. The individual rows are stored 
in sets of three 40-byte rows, the same way as the text display. 
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For more details about the way 
the displays are generated, see 
Chapter 7. 


All of the display modes except 80-column mode and double high- 
resolution graphics mode can use either of two display pages. The 
display maps show addresses for each mode’s Page 1 only. To 
obtain addresses for text or low-resolution graphics Page 2, add 
1024 ($400); to obtain addresses for high-resolution Page 2, add 
8192 ($2000). 


The 80-column display and double higk-resolution graphics mode 
work a little differently. Half of the data is stored in the normal text 
Page-1 memory, and the other half is stored in memory on the 80- 
column text card using the same addresses. The display circuitry 
fetches bytes from these two memory areas simultaneously and 
displays them sequentially: first the byte from the 80-column text 
card memory, then the byte from the main memory. The main 
memory stores the characters in the odd columns of the display, 
and the 80-column text card memory stores the characters in the 
even columns. 


To store display data on the 80-column text card, first turn on the 
80STORE soft switch by writing to location 49153 (hexadecimal 
$C001 or complementary —16383). With 80STORE on, the page- 
select switch, PAGE2, selects between the portion of the 80-column 
display stored in Page 1 of main memory and the portion stored in 
the 80-column text card memory. To select the 80-column text 
card, turn the PAGEZ2 soft switch on by reading or writing at location 
49237. 
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Map of 40-column text display 
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Map of 80-column text display 
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Map of low-resolution graphics display 
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Important 


Electrical specifications of the 
speaker circuit appear in 
Chapter 7. 


Secondary inputs and outputs 


In addition to the primary I/O devices—the keyboard and 
display—there are several secondary input and output devices in 
the Apple Ile. These devices are 


the speaker (output) 
cassette input and output 
annunciator outputs 
strobe output 


switch inputs 


GO @ @ Oe a 


analog (hand control) inputs 


These devices are similar in operation to the soft switches described 
in the preceding section: you control them by reading or writing to 
dedicated memory locations. Action takes place any time your 
program reads or writes to one of these locations; information 
written is ignored. 


Some of these devices toggle—change state—each time they 


are accessed. If you write using an indexed store operation, 
the Apple lle’s microprocessor activates the address bus twice 
during successive clock cycles, causing a device that toggles 
each time it is addressed to end up back in its original state. For 
this reason, you should read, rather than write, to such 
devices. 


The speaker 


The Apple Ile has a small speaker mounted toward the front of the 
bottom plate. The speaker is connected to a soft switch that toggles, 
it has two states, off and on, and it changes from one to the other 
each time it is accessed. (At low frequencies, less than 400 Hz or so, 
the speaker clicks only on every other access.) 


If you switch the speaker once, it emits a click; to make longer 
sounds, you access the speaker repeatedly. You should always use a 
read operation to toggle the speaker. If you write to this soft switch, 
it switches twice in rapid succession. The resulting pulse is so short 
that the speaker doesn’t have time to respond; it doesn’t make a 
sound. 
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BELL] Is described in Appendix B. 


Detailed electrical specifications 
for the cassette input and 
output are given In Chapter 7. 


WRITE Is described in Appendix B. 


The soft switch for the speaker uses memory location 49200 
(hexadecimal $C030). From Integer BASIC, use the 
complementary address —16336. You can make various tones and 
buzzes with the speaker by using combinations of timing loops in 
your program. There is also a routine in the built-in firmware to 
make a beep through the speaker. This routine is named BELL1. 


Cassette input and output 


There are two miniature phone jacks on the back panel of the 
Apple Ile. You can use a pair of standard cables with miniature 
phone plugs to connect an ordinary cassette tape recorder to the 
Apple Ile and save programs and data on audio cassettes. 


The phone jack marked with a picture of an arrow pointing toward a 
cassette is the output jack. It’s connected to a toggled soft switch, like 
the speaker switch described above. The signal at the phone jack 
switches from 0 to 25 millivolts or from 25 millivolts to 0 each time 
you access the soft switch. 


If you connect a cable from this jack to the microphone input of a 
cassette tape recorder and switch the recorder to record mode, the 
signal changes you produce by accessing this soft switch will be 
recorded on the tape. The cassette output switch uses memory 
location 49184 (hexadecimal $C020; complementary value 
~16352). Like the speaker, this output will toggle twice if you write to 
it, so you should only use read operations to control the cassette 
output. 


The standard method for writing computer data on audio tapes uses 
tones with two different pitches to represent the binary states zero 
and one. To store data, you convert the data into a stream of bits 
and convert the bits into the appropriate tones. To save you the 
trouble of actually programming the tones, and to ensure 
consistency among all Apple II cassette tapes, there is a built-in 
routine named WRITE for producing cassette data output. 


The phone jack marked with a picture of an arrow coming from a 
cassette is the input jack. It accepts a cable from the cassette 
recorder’s earphone jack. The signal from the cassette is one volt 
(peak-to-peak) audio. Each time the instantaneous value of this 
audio signal changes from positive to negative, or vice versa, the 
state of the cassette input circuit changes from zero to one or vice 
versa. You can read the state of this circuit at memory location 
49248 (hexadecimal $C060, or complementary decimal —16288). 
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READ is described in Appendix B. 


Complete electrical 
specifications of these inputs 
and outputs are given in 
Chapter 7. 


For electrical specifications of 
the annunciator outputs, refer 
to Chapter 7. 


When you read this location, you get a byte, but only the high-order 
bit (bit 7) is valid. If you are programming in machine language, 
this is the sign bit, so you can perform a Branch Plus or Branch 
Minus immediately after reading this byte. BASIC is too slow to keep 
up with the audio tones used for data recording on tape, but you 
don’t need to write the program: there is a built-in routine named 
READ for reading data from a cassette. 


The hand control connector signals 


Several inputs and outputs are available on a 9-pin D-type miniature 
connector on the back of the Apple Ie: three one-bit inputs, or 
switches, and four analog inputs. These signals are also available on 
the 16-pin IC connector on the main circuit board, along with four 
one-bit outputs and a data strobe. You can access all of these signals 
from your programs. 


Ordinarily, you connect a pair of hand controls to the 9-pin 
connector. The rotary controls use two analog inputs, and the push- 
buttons use two one-bit inputs. However, you can also use these 
inputs and outputs for many other jobs. For example, two analog 
inputs can be used with a two-axis joystick. Table 7-19 shows the 
connector pin numbers. 


Annunciator outputs 


The four one-bit outputs are called annunciators. Each annunciator 
can be used to turn a lamp, a relay, or some similar electronic 
device on and off. 


Each annunciator is controlled by a soft switch, and each switch 
uses a pair of memory locations. These memory locations are 
shown in Table 2-10. Any reference to the first location of a pair 
turns the corresponding annunciator off; a reference to the second 
location turns the annunciator on. There is no way to read the state 
of an annunciator. 
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Table 2-10 
Annunciator memory locations 


Annunciator Address 

No. Pin* State Decimal Hex 

0 15 Off 49240 -16296 $C058 
On 49241 -16295  $ C059 

1 14 Off 49242 -16294 $CO5A 
On 49243 -16293 $C05B 

2 13 Off 49244 -16292  $C0S5C 
On 49245 -16291 $CO5D 

3 12 Off 49246 -16290 $COSE 
On 49247 -16289  $COSF 


* Pin numbers given are for the 16-pin IC connector on the circuit board. 


Strobe output 


The strobe output is normally at +5 volts, but it drops to zero for 
about half a microsecond any time its dedicated memory location 
is accessed. You can use this signal to control functions such as data 
latching in external devices. If you use this signal, remember that 
memory is addressed twice by a write; if you need only a single 
pulse, use a read operation to activate the strobe. The memory 
location for the strobe signal is 49216 (hexadecimal $C040 or 
complementary —16320). 


Switch inputs 


The three one-bit inputs can be connected to the output of another 
electronic device or to a pushbutton. When you read a byte from 
one of these locations, only the high-order bit—bit 7—is valid 
information, the rest of the byte is undefined. From machine 
language, you can do a Branch Plus or Branch Minus on the state of 
bit 7. From BASIC, you read the switch with a PEEK and compare 
the value with 128. If the value is 128 or greater, the switch is on. 


The memory locations for these switches are 49249 through 49251 
(hexadecimal $C061 through $C063, or complementary —16287 
through —16285), as shown in Table 2-12. Switch 0 and switch 1 are 
permanently connected to the Open Apple and Solid Apple Cor 
Option, on the extended keyboard Ile) keys on the keyboard; these 
are the ones normally connected to the buttons on the hand 
controls. Some software for the older models of the Apple II uses 
the third switch, switch 2, as a way of detecting the Shift key. This 
technique requires a hardware modification known as the single- 
wire Shift-key mod. 
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Extended keyboard lle 


Warning 


Refer to the section “Game |/O 
Signals” In Chapter 7 for details. 


You should be sure that you really need the Shift-key mod before 
you go ahead and do it. It probably is not worth it unless you have a 
program that requires the Shift-key mod that you cannot either 
replace or modify to work without it. 


The extended keyboard Ile already has the single-wire Shift-key 


mod hardwired on the logic board. 


if you make the Shift-key modification and connect a joystick 
or other hand control that uses switch 2, you must be careful 
never to close the switch and press Shift at the same time: 
doing so produces a short circuit that causes the power supply 
to turn off. When this happens, any programs or data in the 
computer's internal memory are lost. 


“ Shift-key mod: To perform this modification on your 
Apple Ile, all you have to do is solder across the broken 
diamond labeled X6 on the main circuit board. Remember to 
turn off the power before changing anything inside the 
Apple Ile. Also remember that changes such as this are at your 
own risk and may void your warranty. 


Analog inputs 


The four analog inputs are designed for use with 150K ohm variable 
resistors or potentiometers. The variable resistance is connected 
between the +5V supply and each input, so that it makes up part of a 
timing circuit. The circuit changes state when its time constant has 
elapsed, and the time constant varies as the resistance varies. Your 
program can measure this time by counting in a loop until the 
circuit changes state, or times out. 


Before a program can read the analog inputs, it must first reset the 
timing circuits. Accessing memory location 49264 (hexadecimal 
$C070 or complementary —16272) does this. As soon as you reset 
the timing circuits, the high bits of the bytes at locations 49252 
through 49255 (hexadecimal $C064 through $C067 or 
complementary —16284 through —16281) are set to 1. If you PEEK at 
them from BASIC, the values will be 128 or greater. Within about 3 
milliseconds, these bits will change back to 0—byte values less than 
128—and remain there until you reset the timing circuits again. The 
exact time each of the four bits remains high is directly 
proportional to the resistance connected to the corresponding 
input. If these inputs are open—no resistances are connected—the 
corresponding bits may remain high indefinitely. 
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PREAD is described in Appendix B. 


To read the analog inputs from machine language, you can use a 
program loop that resets the timers and then increments a counter 
until the bit at the appropriate memory location changes to 0, or 
you can use the built-in routine named PREAD. High-level 
languages, such as BASIC, also include convenient means of 
reading the analog inputs: refer to your language manuals. 


Summary of secondary I/O locations 


Table 2-11 shows the memory locations for all of the built-in I/O 
devices except the keyboard and display. As explained earlier, 
some soft switches should only be accessed by means of read 
operations, those switches are marked. 


Table 2-11 
Secondary |/O memory locations 

Address 
Function Decimal Hex Access 
Speaker 49200 -16336 $C030 Read only 
Cassette out 49184 -16352 $C020 Read only 
Cassette in 49248 -16288 $C060 Read only 
Annunciator 0 on 49241 -16295  $C059 
Annunciator 0 off 49240 -16296 $C058 
Annunciator 1 on 49243 -16293  $COSB 
Annunciator 1 off 49242 -16294  $COSA 
Annunciator 2 on 49245 -16291 $CO5D 
Annunciator 2 off 49244 -16292 $CO5C 
Annunciator 3 on 49247 -16289  $COSF 
Annunciator 3 off 49246 -16290 $CO0S5E 
Strobe output 49216 -16320  $C040 Read only 
Switch input 0 (@) 49249 -16287 $C061 Read only 
Switch input 1 () 49250 -16286 $C062 Read only 
Switch input 2 49251 -16285  $C063 Read only 
Analog input reset 49264 -16272 $C070 
Analog input 0 49252 16284 $C064 Read only 
Analog input 1 49253 -16283  $C065 Read only 
Analog input 2 49254 -16282  $C066 Read only 
Analog input 3 49255 -16281  $C067 Read only 


Note: For connector identification and pin numbers, refer to Tables 7-18 
and 7-19. 
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The Monitor, or System Monitor, 
is a computer program that is 
used to operate the computer at 
the machinetanguage level. 
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Important 


Almost every program on the Apple Ile takes input from the 
keyboard and sends output to the display. The Monitor and the 
Applesoft and Integer BASICs do this by means of standard I/O 
subroutines that are built into the Apple Ie’s firmware. Many 
application programs also use the standard I/O subroutines, but 
Pascal programs do not; Pascal has its own I/O subroutines. 


This chapter describes the features of these subroutines as they are 
used by the Monitor and by the BASIC interpreters, and tells you 
how to use the standard subroutines in your assembly-language 
programs. 


High-level languages already include convenient methods for 
handling most of the functions described in this chapter. You 
should not need to use the standard I/O subroutines in your 
programs unless you are programming in assembly language. 


Table 3-1 

Monitor firmware routines 

LocationO Name Description 

$C305 BASICIN With 80-column firmware active, 


displays solid, blinking cursor; 
accepts character from keyboard 


$C307 BASICOUT Displays a character on the screen; 
used when the 80-column firmware is 
active (Chapter 3) 


$FC9C CLREOL Clears to end of line from current 
cursor position 

$FC9E CLEOLZ Clears to end of line using contents of 
Y register as cursor position 

$FC42 CLREOP Clears to bottom of window 

$F832 CLRSCR Clears the low-resolution screen 

$F836 CLRTOP Clears top 40 lines of low-resolution 
screen 

$FDED COUT Calls output routine whose address is 
stored in CSW (normally COUT1, 
Chapter 3) 

$FDFO COUT1 Displays a character on the screen 


(Chapter 3) 
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Table 3-1 (continued) 
Monitor firmware routines 


LocationO Name Description 

$FD8E CROUT Generates a carriage return character 

$FD8B CROUT1 Clears to end of line, then generates a 
carriage return character 

$FD6A GETLN Displays the prompt character, 


accepts a string of characters by 
means of RDKEY 


$F819 HLINE Draws a horizontal line of blocks 

$FC58 HOME Clears the window and puts cursor in 
upper-left corner of window 

$FD1B KEYIN With 80-column firmware inactive, 


displays checkerboard cursor; 
accepts character from keyboard 


$F800 PLOT Plots a single low-resolution block on 
the screen 

$F94A PRBL2 Sends 1 to 256 blank spaces to the 
output device 

$FDDA PRBYTE Prints a hexadecimal byte 

$FF2D PRERR Sends ERR and Control-G to the 
output device 

$FDE3 PRHEX Prints 4 bits as a hexadecimal number 

$F941 PRNTAX Prints contents of A and X in 
hexadecimal 

$FDOC RDKEY Displays blinking cursor; goes to 


standard input routine, normally 
KEYIN or BASICIN 


$F871 SCRN Reads color value of a low-resolution 
block 
$F864 SETCOL Sets the color for plotting in low 
resolution 
$FC24 VTABZ Sets cursor vertical position 
$F828 VLINE Draws a vertical line of low-resolution 
blocks 
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AUXMOVE and XFER are 
described in the section 
“Auxiliary-Memory Subroutines” 
in Chapter 4. 


The standard I/O subroutines listed in Table 3-1 are fully described 
in this chapter. The Apple Ile firmware also contains many other 
subroutines that you might find useful. Those subroutines are 
described in Appendix B. Two of the built-in subroutines, 
AUXMOVE and XFER, can help you use the optional auxiliary 
memory. 


Using the I/O subroutines 


Before you use the standard I/O subroutines, you should 
understand a little about the way they are used. The Apple Ile 
firmware operates differently when an option such as an 80-column 
text card is used. This section describes general situations that affect 
the operation of the standard I/O subroutines. Specific instances 
are described in the sections devoted to the individual subroutines. 


Apple II compatibility 


Compared with older Apple II models, the Apple Ile has some 
additional keyboard and display features. To run programs that 
were written for the older models, you can make the Apple IIe 
resemble an Apple II Plus by turning those features off. The features 
that you can turn off and on to put the Apple Ile into and out of 
Apple II mode are listed in Table 3-2. 


Table 3-2 
Apple Il mode 

Apple lle Apple Il mode 
Keyboard Uppercase and lowercase Uppercase only 


Display characters Inverse and normal only Flashing, inverse, 
and normal 


Display size 40-column; also 80-column 40-column only 
with optional card 


If the Apple Ie does not have an 80-column text card installed in 
the auxiliary slot, it is almost in Apple II mode as soon as you turn it 
on or reset it. One exception is the keyboard, which is both 
uppercase and lowercase. 
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Original Ile 


The primary and alternate 
character sets are described in 
Chapter 2 in the section “Text 
Character Sets.” 


Original lle 


The ALTCHAR soft switch is 
described in Chapter 2. 


On an original Apple lle, statements in Integer BASIC, Applesoft, 


and DOS 3.3 commands must be typed in uppercase letters. To 
be compatible with older software, you should switch the 
Apple lle keyboard to uppercase by pressing Caps Lock. 


Another feature on the Apple Ile that differs from the Apple II is the 
displayed character set. An Apple II displays only uppercase 
characters, but it displays them in three ways: normal, inverse, and 
flashing. The Apple IIe can display uppercase characters all three 
ways, and it can display lowercase characters in the normal way. 
This combination is called the primary character set. When the 
Apple Ile is first turned on or reset, it displays the primary character 
set. 


The Apple Ile has another character set, called the aliernate 
character set, that displays a full set of normal and inverse 
characters, with the inverse uppercase characters between $40 and 
$5F replaced on enhanced Apple Ile’s with MouseText characters. 


In the original Apple lle, uppercase inverse characters appear 
In place of the MouseText characters of the enhanced Apple lle 
and the Apple lic. 


You can switch character sets at any time by means of the ALTCHAR 
soft switch. 


The 80-column firmware 


There are a few features that are normally available only with the 80- 
column display. These features are identified in Table 3-3b and 
Table 3-6. The firmware that supports these features is built into the 
Apple Ile, but it is normally active only if an 80-column text card is 
installed in the auxiliary slot. 


When you turn on power or reset the Apple Ile, the 80-column 
firmware is inactive and the Apple Ile displays the primary 
character set, even if an 80-column text card is installed. When you 
activate the 80-column firmware, it switches to the alternate 
character set. 


The built-in 80-column firmware is implemented as if it were 
installed in expansion slot 3. Programs written for an Apple II or 
Apple II Plus with an 80-column text card installed in slot 3 usually 
will run properly on a Apple Ie with an 80-column text card in the 
auxiliary slot. 
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See the section “Switching I/O 
Memory” in Chapter 6 for 


details. 


Important 


SLOTC3ROM is described 
Chapter 6 in the section 
“Switching I/O Memory.” 


in 


For more information about 


interrupts, see Chapter 6. 


Warning 


If the Apple Ile has an 80-column text card and you want to use the 
80-column display, you can activate the built-in firmware from 
BASIC by typing PR#3. 


To activate the 80-column firmware from the Monitor, press 3, then 
Control-P. Notice that this is the same procedure you use to activate 
a card in expansion slot 3. Any card installed in the auxiliary slot 
takes precedence over a card installed in expansion slot 3. 


Even though you activated the 80-column firmware by typing 
PR#3, you should never deactivate it by typing PR#0, because 
that just disconnects the firmware, leaving several soft switches 
still set for 80-column operation. Instead, press the sequence 
Escape-Q (see Table 3-6). 


If there is no 80-column text card or other auxiliary memory card in 
your Apple Ile, you can still activate the 80-column firmware and 
use it with a 40-column display. First, set the SLOTC3ROM soft 
switch located at $COOA (49162). Then type PR#3 to transfer control 
to the firmware. 


When the 80-column firmware is active without a card in the 
auxiliary slot, it does not work quite the same as it does with a card. 
The functions that clear the display (CLREOL, CLEOLZ, CLREOP, 
and HOME) work as if the firmware were inactive: they always clear 
to the current color. In addition, interrupts are supported only with 
a card installed in the auxiliary slot. 


If you do not have an interface card in either the auxiliary slot 
or slot 3, don’t try to activate the firmware with PR#3. Typing 
PR#3 with no card installed transfers control to the empty 
connector, with unpredictable results. 


Programs activate the 80-column firmware by transferring control 
to address $C300. If there is no card in the auxiliary slot, you must 
set the SLOTC3ROM soft switch first. To deactivate the 80-column 
firmware from a program, write a Control-U character via 
subroutine COUT. 


Chapter 3: Built-in 1/O Firmware 


For more information about the 
1/O links, see the section 
“Changing the Standard |/O 
Links” in Chapter 6. 


The old monitor 


Apple II’s and Apple II Pluses used a version of the System Monitor 
different from the one the Apple Ile uses. It had the same standard 
I/O subroutines, but a few of the features were different; for 
example, there were no arrow keys for cursor motion. If you start the 
Apple Ile with a DOS or BASIC disk that loads Integer BASIC into 
the bank-switched area in RAM, the old Monitor (sometimes called 
the Autostart Monitor is also loaded with it. When you type INT 
from Applesoft to activate Integer BASIC, you also activate this 
copy of the old Monitor, which remains active until you either type 
FP to switch back to Applesoft, which uses the new Monitor in ROM, 
or type PR#3 to activate the 80-column firmware. Part of the 
firmware’s initialization procedure checks to see which version of 
the Monitor is in RAM. If it finds the old Monitor, it replaces it with 
a copy of the new Monitor from ROM. After the firmware has 
copied the new Monitor into RAM, it remains there until the next 
time you start up the system. 


The standard I/O links 


When you call one of the character I/O subroutines (COUT and 
RDKEY), the first thing that happens is an indirect jump to an 
address stored in programmable memory. Memory locations used 
for transferring control to other subroutines are sometimes called 
vectors; in this manual, the locations used for transferring control 
to the I/O subroutines are called I/O links. In a Apple Ile running 
without a disk operating system, each I/O link is normally the 
address of the body of the subroutine (COUT1 or KEYIN). If a disk 
operating system is running, one or both of these links hold the 
addresses of the corresponding DOS or ProDOS I/O routines 
instead. (DOS and ProDOS maintain their own links to the standard 
1/O subroutines.) 


By calling the I/O subroutines that jump to the link addresses 
instead of calling the standard subroutines directly, you ensure that 
your program will work properly in conjunction with other software, 
such as DOS or a printer driver, that changes one or both of the I/O 
links. 


For the purposes of this chapter, we shall assume that the I/O links 
contain the addresses of the standard I/O subroutines—COUT1 and 
KEYIN if the 80-column firmware is off, and BASICOUT and 
BASICIN if it is on. 
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Standard output features 


The standard output routine is named COUT, pronounced “C-out,” 
which stands for character out. COUT normally calls COUT1, 
which sends one character to the display, advances the cursor 
position, and scrolls the display when necessary. COUT1 restricts 
its use of the display to an active area called the text window, 
described below. 


COUT output subroutine 


Your program makes a subroutine call to COUT at memory location 
$FDED with a character in the accumulator. COUT then passes 
control via the output link CSW to the current output subroutine, 
normally COUT1 (or BASICOUT), which takes the character in the 
accumulator and writes it out. If the accumulator contains an 
uppercase or lowercase letter, a number, or a special character, 
COUT! displays it; if the accumulator contains a control character, 
COUT! either performs one of the special functions described 
below or ignores the character. 


Each time you send a character to COUT1, it displays the character 
at the current cursor position, replacing whatever was there, and 
then advances the cursor position one space to the right. If the 
cursor position is already at the right edge of the window, COUT1 
moves it to the leftmost position on the next line down. If this would 
move the cursor position past the end of the last line in the window, 
COUT! scrolls the display up one line and sets the cursor position at 
the left end of the new bottom line. 


The cursor position is controlled by the values in memory locations 
36 and 37 (hexadecimal $24 and $25). These locations are named 
CH, for cursor horizontal, and CV, for cursor vertical. COUT1 does 
not display a cursor, but the input routines described below do, and 
they use this cursor position. If some other routine displays a 
cursor, it will not necessarily put it in the cursor position used by 
COUT1. 
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Control characters with COUT] and BASICOUT 


COUT1 and BASICOUT do not display control characters. Instead, 
the control characters listed in Tables 3-3a and 3-3b are used to 
initiate some action by the firmware. Other control characters are 
ignored. Most of the functions listed here can also be invoked from 
the keyboard, either by typing the control character listed or by 
using the appropriate escape code, as described in the section 
“Escape Codes With KEYIN and BASICIN” later in this chapter. The 
stop-list function, described separately, can only be invoked from 
the keyboard. 


Table 3-3a 

Control characters, 80-column firmware off 

Control ASCll Apple lle 

character name name Action taken by COUT! 

Control-G BEL Bell Produces a 1000 Hz tone 
for 0.1 second 

Control-H BS Backspace Moves cursor position one 
space to the left; from left 
edge of window, moves to 
right end of line above 

Control-J LF Line feed Moves cursor position 
down to next line in 
window, scrolls if needed 

Control-M CR Return Moves cursor position to 
left end of next line in 
window, scrolls if needed 

Table 3-3b 

Control characters, 80-column firmware on 

Control ASCII Apple lle 

character name name Action taken by BASICOUT 

Control-G BEL Bell Produces a 1000 Hz tone 
for 0.1 second 

Control-H BS Backspace Moves cursor position one 


space to the left; from left 
edge of window, moves to 
right end of line above 
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Table 3-3b (continued) 


Control characters, 80-column firmware on 


Control 
character 


Control-J 


Control-K* 


Control-L* 


Control-M 


Control-N* 


Control-O* 


Control-Q* 
Control-R* 
Control-St 


Control-U* 


Control-V* 


Control-W* 


Control-X 
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ASCII 
name 


LF 


CR 


SO 


SI 


DCl1 
DC2 
DC3 


NAK 


SYN 


ETB 


CAN 


Apple lle 
name 


Line feed 


Clear EOS 


Home 
and clear 


Return 


Normal 


Inverse 


40-column 
80-column 


Stop-list 


Quit 


Scroll 


Scroll-up 


Disable 
MouseText 


Action taken by BASICOUT 


Moves cursor position 
down to next line in 
window; scrolls if needed 


Clears from cursor 
position to the end of the 
screen 


Moves cursor position to 
upper-left corner of 
window and clears window 


Moves cursor position to 
left end of next line in 
window, scrolls if needed 


Sets display format 
normal 


Sets display format 
inverse 


Sets display to 40-column 
Sets display to 80-column 


Stops listing characters on 
the display until another 
key is pressed 


Deactivates 80-column 
video firmware 


Scrolls the display down 
one line, leaving the 
cursor in the current 
position 


Scrolls the display up one 
line, leaving the cursor in 
the current position 


Disables MouseText 
character display; use 
inverse uppercase 


Table 3-3b (continued) 
Control characters, 80-column firmware on 


Control ASCII Apple lle 

character name name Action taken by BASICOUT 

Control-Y* EM Home Moves cursor position to 
upper-left corner of 
window (but doesn’t 
clear) 

Control-Z* SUB Clear line Clears the line the cursor 
position is on 

Control-[ ESC Enable Maps inverse 

MouseText uppercase characters to 

MouseText characters 

Control-\* — FS Forward Moves cursor position one 

space space to the right, from 

right edge of window, 
moves it to left end of line 
below 

Control-]* GS Clear EOL Clears from the current 
cursor position to the end 
of the line (that is, to the 
right edge of the window) 

Control-_ US Up Moves cursor up a line, no 
scroll 


* Doesn't work from the keyboard 
t Only works from the keyboard 


The stop-list feature 


When you are using any program that displays text via COUT1 (or 
BASICOUT), you can make it stop updating the display by holding 
down Control and pressing S. Whenever COUT! gets a carriage 
return from the program, it checks to see if you have pressed 
Control-S. If you have, COUT1 stops and waits for you to press 
another key. When you want COUT] to resume, press another key; 
COUT! will send the carriage return it got earlier to the display, 
then continue normally. The character code of the key you pressed 
to resume displaying is ignored unless you pressed Control-C. 
COUT1 passes Control-C back to the program; if it is a BASIC 
program, this enables you to terminate the program while in stop- 
list mode. 
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Original Ile 


Warning 


The text window 


After starting up the computer or after a reset, the firmware uses the 
entire display. However, you can restrict video activity to any 
rectangular portion of the display you wish. The active portion of 
the display is called the text window. COUT1 or BASICOUT puts 
characters into the window only; when it reaches the end of the last 
line in the window, it scrolls only the contents of the window. 


You can set the top, bottom, left side, and width of the text window 
by storing the appropriate values into four locations in memory. 
This enables your programs to control the placement of text in the 
display and to protect other portions of the screen from being 
written over by new text. 


Memory location 32 (hexadecimal $20) contains the number of the 
leftmost column in the text window. This number is normally 0, the 
number of the leftmost column in the display. In a 40-column 
display, the maximum value for this number is 39 (hexadecimal 
$27); in an 80-column display, the maximum value is 79 
(hexadecimal $4F). 


Memory location 33 (hexadecimal $21) holds the width of the text 
window. For a 40-column display, it is normally 40 (hexadecimal 
$28); for an 80-column display, it is normally 80 

(hexadecimal $50). 


COUT] truncates the column width to an even value on the 
original Apple lle. 


On an original Apple lle, be careful not to let the sum of the 
window width and the leftmost position in the window exceed 
the width of the display you are using (40 or 80). If this happens, 
it is possible for COUT1 to put characters Into memory locations 
outside the display page. possibly Into your current program or 
data space. 


Memory location 34 (hexadecimal $22) contains the number of the 
top line of the text window. This is normally 0, the topmost line in 
the display. Its maximum value is 23 (hexadecimal $17). 


Memory location 35 (hexadecimal $23) contains the number of the 
bottom line of the screen, plus 1. It is normally 24 (hexadecimal 
$18) for the bottom line of the display. Its minimum value is 1. 
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After you have changed the text window boundaries, nothing is 
affected until you send a character to the screen. 


Warning Any time you change the boundaries of the text window, you 
should make sure that the current cursor position (stored at CH 
and CV) Is Inside the new window. If it is outside, it is possible for 
COUT] to put characters into memory locations outside the 
display page, possibly destroying programs or data. 


Table 3-4 summarizes the memory locations and the possible 
values for the window parameters. 


Table 3-4 
Text window memory locations 
Normal values Maximum values 
Minimum 
Location value 40 col. 80 col 40 col 80 col 

Window —— TOO a a os ——— 
parameter Dec Hex Dec Hex Dec Hex Dec Hex Dec Hex Dec Hex 
Left edge 32 $20 00 $00 00 $00 00 $00 39 $27 79 $4F 
Width 33 $21 00 $00 40 $28 80 $50 40 $28 80 $50 
Top edge 34 $22 O00 $00 00 $00 00 $00 23 £$17 «223 ~~ $17 


Bottom edge 35 $2301 $01 24 $18 24 $18 24 $18 24 $18 


Table 3-5 


Text format contro! values Inverse and flashing text 


Subroutine COUT1 can display text in normal format, inverse 
format, or, with some restrictions, flashing format. The display 
Dec Hex Display format format for any character in the display depends on two things: the 
character set being used at the moment, and the setting of the two 
255 $FF Normal, uppercase, high-order bits of the character’s byte in the display memory. 


and lowercase As it sends your text characters to the display, COUT1 sets the high- 
127 $7F Flashing, uppercase, order bits according to the value stored at memory location 50 

and symbols chexadecimal $32). If that value is 255 (hexadecimal $FF), COUT1 
sets the characters to display in normal format; if the value is 63 
(hexadecimal $3F), COUT! sets the characters to inverse format. If 


Mask value 


63 $3F Inverse, uppercase, 


and lowercase the value is 127 (hexadecimal $7F) and if you have selected the 
Note: These mask values apply primary character set, the characters will be displayed in flashing 
only to the primary character set format. Note that flashing format is not available in the alternate 
(see text). character set. 
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Important 


Switching between character 
sets is described in the section 
“Display Mode Switching” in 
Chapter 2. 


Original Ile 


For more information on GETLN, 
see the section “Editing With 
GETLN” later in this chapter. 


To control the display format of the characters, routine COUT1 uses 
the value at location 50 as a logical mask to force the setting of the 
two high-order bits of each character byte it puts into the display 
page. It does this by performing the logical AND function on the 
data byte and the mask byte. The result byte contains a 0 in any bit 
that was 0 in the mask. BASICOUT, used when the 80-column 
firmware is active, changes only the high-order bit of the data. 


If the 80-column firmware is inactive and you store a mask 
value at location 50 with zeros in its low-order bits, COUT] will 
mask out those bits in your text. As a result, some characters 
will be transformed Into other characters. You should set the 
mask to the values given in Table 3-5 only. 


If you set the mask value at location 50 to 127 (hexadecimal $7F), 
the high-order bit of each result byte will be 0, and the characters 
will be displayed either as lowercase or as flashing, depending on 
which character set you have selected. Refer to the tables of display 
character sets in Chapter 2. In the primary character set, the next- 
highest bit, bit 6, selects flashing format with uppercase characters. 
With the primary character set you can display lowercase characters 
in normal format and uppercase characters in normal, inverse, and 
flashing formats. In the alternate character set, bit 6 selects 
lowercase or special characters. With the alternate character set you 
can display uppercase and lowercase characters in normal and 
inverse formats. 


On the original Apple lle, the MouseText characters are 
replaced by uppercase Inverse characters. 


Standard input features 


The Apple Ile’s firmware includes two different subroutines for 
reading from the keyboard. One subroutine is named RDKEY, 
which stands for read key. It calls the standard character input 
subroutine KEYIN (or BASICIN when the 80-column firmware in 
active), which accepts one character at a time from the keyboard. 


The other subroutine is named GETLN, which stands for get line. By 
making repeated calls to RDKEY, GETLN accepts a sequence of 
characters terminated with a carriage return. GETLN also provides 
on-screen editing features. 
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Escape mode is described in the 
next section, “Escape Codes.” 


RDKEY input subroutine 


A program gets a character from the keyboard by making a 
subroutine call to RDKEY at memory location $FDOC. RDKEY sets 
the character at the cursor position to flash, then passes control via 
the input link KSW to the current input subroutine, which is 
normally KEYIN or BASICIN. 


RDKEY displays a cursor at the current cursor position, which is 
immediately to the right of whatever character you last sent to the 
display (normally by using the COUT routine, described earlier). 
The cursor displayed by RDKEY is a flashing version of whatever 
character happens to be at that position on the screen. It is usually a 
space, so the cursor appears as a blinking rectangle. 


KEYIN input subroutine 


KEYIN is the standard input subroutine when the 80-column 
firmware is inactive; BASICIN is used when the 80-column firmware 
is active. When called, the subroutine waits until the user presses a 
key, then returns with the key code in the accumulator. 


If the 80-column firmware is inactive, KEYIN displays a cursor by 
alternately storing a checkerboard block in the cursor location, 
then storing the original character, then the checkerboard again. If 
the firmware is active, BASICIN displays a steady inverse space 
(rectangle), unless you are in escape mode, when it displays a plus 
sign (+) in inverse format. 


KEYIN also generates a random number. While it is waiting for the 
user to press a key, KEYIN repeatedly increments the 16-bit number 
in memory locations 78 and 79 (hexadecimal $4E and $4F). This 
number keeps increasing from 0 to 65535, then starts over again 

at 0. The value of this number changes so rapidly that there is no 
way to predict what it will be after a key is pressed. A program that 
reads from the keyboard can use this value as a random number or 
as a seed for a random-number routine. 


When the user presses a key, KEYIN accepts the character, stops 
displaying the cursor, and returns to the calling program with the 
character in the accumulator. 
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Escape codes with KEYIN and BASICIN 


KEYIN has special functions that you invoke by typing escape codes 
on the keyboard. An escape code is obtained by pressing Escape, 
releasing it, and then pressing some other key. See Table 3-6; the 
notation in the table means press Escape, release it, then press the 
key that follows. 


Table 3-6 includes three sets of cursor-control keys. The first set 
consists of Escape followed by A, B, C, or D. The letter keys can be 
either uppercase or lowercase. These keys are the standard cursor- 
motion keys on older Apple II models; they are present on the 
Apple Ile primarily for compatability with programs written for old 
machines. 


Cursor motion in escape mode 


The second and third sets of cursor-control keys are listed together 
because they activate escape mode. In escape mode, you can keep 
using the cursor-motion keys without pressing Escape again. This 
enables you to perform repeated cursor moves by holding down the 
appropriate key. 


When the 80-column firmware is active, you can tell when BASICIN 
is in escape mode: it displays a plus sign in inverse format as the 
cursor. You leave escape mode by typing any key other than a 
cursor-motion key. 


The escape codes with the directional arrow keys are the standard 
cursor-motion keys on the Apple Ile. The escape codes with the I, J, 
K, and M keys are the standard cursor-motion keys on the 

Apple II Plus, and are present on the Apple Ile for compatability 
with the Apple II Plus. On the Apple Ile, the escape codes with the I, 
J, K, and M keys function with either uppercase or lowercase letters. 


Table 3-6 

Escape codes 

Escape code Function 

Escape @ : Clears window and homes cursor 


(places it in upper-left corner of 
screen), then exits from escape mode 


Escape A ora Moves cursor right one line; exits from 
escape mode 


Escape B or b Moves cursor left one line; exits from 
escape mode 
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Table 3-6 (continued) 
Escape codes 


Escape code 


Escape C or c 


Escape D or d 


Escape E ore 


Escape F or f 


Escape I or i 
or Escape Up Arrow 


Escape J or j 
or Escape Left Arrow 


Escape K or k 
or Escape Right Arrow 


Escape M or m 
or Escape Down Arrow 


Escape 4 


Escape 8 


Escape Control-D 


Escape Control-E 


Escape Control-Q 


Function 


Moves cursor down one line; exits from 
escape mode 


Moves cursor up one line; exits from 
escape mode 


Clears to end of line; exits from escape 
mode 


Clears to bottom of window; exits from 
escape mode 


Moves the cursor up one line; remains 
in escape mode (see text) 


Moves the cursor left one space; 
remains in escape mode (See text) 


Moves the cursor right one space; 
remains in escape mode (see text) 


Moves the cursor down one line; 
remains in escape mode (see text) 


If 80-column firmware is active, switches 
to 40-column mode; sets links to 
BASICIN and BASICOUT; restores 
normal window size, exits from escape 
mode 


If 80-column firmware is active, switches 
to 80-column mode; sets links to 
BASICIN and BASICOUT; restores 
normal window size; exits from escape 
mode 


Disables control characters; only 
carriage return, line feed, BELL, and 
backspace have an effect when printed 


Reactivates control characters 


If 80-column firmware is active, 
deactivates 80-column firmware; sets 
links to KEYIN and COUT]; restores 
normal window size; exits from escape 
mode 
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Table 3-7 


Prompt characters 


Prompt 
character 


2 


Program requesting 
input 


User’s BASIC program 
(INPUT statement) 


Applesoft BASIC 
(Appendix D) 


Integer BASIC 
(Appendix D) 


Firmware Monitor 
(Chapter 5) 


GETLN input subroutine 


Programs often need strings of characters as input. While it is 
possible to call RDKEY repeatedly to get several characters from 
the keyboard, there is a more powerful subroutine you can use. This 
routine is named GETLN, which stands for get line, and it starts at 
location $FD6A. Using repeated calls to RDKEY, GETLN accepts 
characters from the standard input subroutine—usually 
KEYIN—and puts them into the input buffer located in the memory 
page from $200 to $2FF. GETLN also provides the user with on- 
screen editing and control features, described in the next section, 
“Editing With GETLN.” 


The first thing GETLN does when you call it is display a prompting 
character, called simply a prompt. The prompt indicates to the 
user that the program is waiting for input. Different programs use 
different prompt characters, helping to remind the user which 
program is requesting the input. For example, an INPUT statement 
in a BASIC program displays a question mark (?) as a prompt. The 
prompt characters used by the different programs on the Apple IIe 
are shown in Table 3-7. 


GETIN uses the character stored at memory location 51 
(hexadecimal $33) as the prompt character. In an assembly- 
language program, you can change the prompt to any character you 
wish. In BASIC, changing the prompt character has no effect, 
because both BASIC interpreters and the Monitor restore it each 
time they request input from the user. 


As you type the character string, GETLN sends each character to the 
standard output routine—normally COUT1—which displays it at the 
previous cursor position and puts the cursor at the next available 
position on the display, usually immediately to the right. As the 
cursor travels across the display, it indicates the position where the 
next character will be displayed. 


GETIN stores the characters in its buffer, starting at memory 
location $200 and using the X register to index the buffer. GETLN 
continues to accept and display characters until you press Return; 
then it clears the remainder of the line the cursor is on, stores the 
carriage-return code in the buffer, sends the carriage-return code to 
the display, and returns to the calling program. 
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Important 


The maximum line length that GETLN can handle is 255 characters. 
If the user types more than this, GETLN sends a backslash (\) and a 
carriage return to the display, cancels the line it has accepted so far, 
and starts over. To warn the user that the line is getting full, GETLN 
sounds a bell (tone) at every keypress after the 248th. 


In the Apple Il and the Apple Il Plus, the GETLN routine converts 
all inputs to uppercase. GETLN In the Apple Ile does not do this, 
even in Apple Il mode. To get uppercase Input for BASIC, use 
Caps Lock. 


Editing with GETLN 


Subroutine GETLN provides the standard on-screen editing features 
used by the BASIC interpreters and the Monitor. For an 
introduction to editing with these features, refer to the Applesoft 
Tutorial. Any program that uses GETLN for reading the keyboard 
has these features. 


Cancel line 


Any time you are typing a line, pressing Control-X causes GETLN to 
cancel the line. GETLN displays a backslash (\) and issues a carriage 
return, then displays the prompt and waits for you to type a new 

line. GETLN takes the same action when you type more than 255 
characters, as described earlier. 


Backspace 


When you press Left Arrow, GETLN moves its buffer pointer back 
one space, effectively deleting the last character in its buffer. It also 
sends a backspace character to routine COUT, which moves the 
display position and the cursor back one space. If you type another 
character now, it will replace the character you backspaced over, 
both on the display and in the line buffer. Each time you press Left 
Arrow, it moves the cursor left and deletes another character, until 
you reach the beginning of the line. If you then press Left Arrow one 
more time, you have cancelled the line, and GETLN issues a 
carriage return and displays the prompt. 
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Retype 


Right Arrow has a function complementary to the backspace 
function. When you press Right Arrow, GETLN picks up the 
character at the display position just as if it had been typed on the 
keyboard. You can use this procedure to pick up characters that you 
have just deleted by backspacing across them. You can use the 
backspace and retype functions with the cursor-motion functions to 
edit data on the display. (See the earlier section “Cursor Motion in 
Escape Mode.”) 


Monitor firmware support 


Table 3-8 summarizes the addresses and functions of the video 
display support routines the Monitor provides. These routines are 
described in the subsections that follow. 


Table 3-8 
Video firmware routines 


Location Name Description 


$C307 BASICOUT Displays a character on the screen 
when 80-column firmware is active 


$FCOC CLREOL Clears to end of line from current 
cursor position 

$FCOE CLEOLZ Clears to end of line using contents of 
Y register as cursor position 

$FC42 CLREOP Clears to bottom of window 

$F832 CLRSCR Clears the low-resolution screen 

$F836 CLRTOP Clears top 40 lines of low-resolution 
screen 

$FDED COUT Calls output routine whose address is 
stored in CSW (normally COUT], 
Chapter 3) 

$FDFO COUT1 Displays a character on the screen 
(Chapter 3) 

$FD8E CROUT Generates a carriage return character 

$FD8B CROUT1 Clears to end of line, then generates a 


carriage return character 
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Table 3-8 (continued) 
Video firmware routines 


Location Name Description 

$F819 HLINE Draws a horizontal line of blocks 

$FC58 HOME Clears the window and puts cursor in 
upper-left corner of window 

$F800 PLOT Plots a single low-resolution block on 
the screen 

$F94A PRBL2 Sends 1 to 256 blank spaces to the 
output device whose address is in CSW 

$FDDA PRBYTE Prints a hexadecimal byte 

$FF2D PRERR Sends ERR and Control-G to the output 
device whose output routine address is 
in CSW 

$FDE3 PRHEX Prints 4 bits as a hexadecimal number 

$F941 PRNTAX Prints contents of A and X in 
hexadecimal 

$F871 SCRN Reads color value of a low-resolution 
block on the screen 

$F864 SETCOL Sets the color for plotting in low 
resolution 

$FC24 VTABZ Sets cursor vertical position Setting CV 


at location $25 does not change 
vertical positon until a carriage return.) 


$F828 VLINE Draws a vertical line of low-resolution 
blocks 


BASICOUT, $C307 


BASICOUT is essentially the same as COUTI—BASICOUT is used 
instead of COUT1 when the 80-column firmware is active. 
BASICOUT displays the character in the accumulator on the display 
screen at the current cursor position and advances the cursor. It 
places the character using the setting of the inverse mask (location 
$32). BASICOUT handles control characters; see Table 3-3b. 
When it returns control to the calling program, all registers are 
intact. 
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See the section “Control 
Characters With COUT] and 
BASICOUT” earlier in this 
chapter for more information on 
COUTI. 


CLREOL, $FC9C 


CLREOL clears a text line from the cursor position to the right edge 
of the window. This routine destroys the contents of A and Y. 


CLEOLZ, $FC9E 


CLEOLZ clears a text line to the right edge of the window, starting at 
the location given by base address BASL, which is indexed by the 
contents of the Y register. This routine destroys the contents of A 
and Y. 


CLREOP, $FC42 


CLREOP clears the text window from the cursor position to the 
bottom of the window. This routine destroys the contents of A 
and Y. 


CLRSCR, $F832 


CLRSCR clears the low-resolution graphics display to black. If you 
call this routine while the video display is in text mode, it fills the 
screen with inverse-mode at-sign (@) characters. This routine 
destroys the contents of A and Y. 


CLRTOP, $F836 


CLRTOP is the same as CLRSCR, except that it clears only the top 40 
rows of the low-resolution display. 


COUT, $FDED 


COUT calls the current character output subroutine. (See the 
section “COUT Output Subroutine” earlier in this chapter.) The 
character to be sent to the output device should be in the 
accumulator. COUT calls the subroutine whose address is stored in 
CSW (locations $36 and $37), which is usually the standard 
character output subroutine COUT1 (or BASICOUT). 


COUT1, $FDFO 


COUT! displays the character in the accumulator on the display 
screen at the current cursor position and advances the cursor. It 
places the character using the setting of the inverse mask 

docation $32). It handles these control characters: carriage return, 
line feed, backspace, and bell. When it returns control to the 
calling program, all registers are intact. 
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CROUT, $FD8E 


CROUT sends a carriage return to the current output device. 


CROUT1, $FD8B 


CROUT]1 clears the screen from the current cursor position to the 
edge of the text window, then calls CROUT. 


HLINE, $F819 


HLINE draws a horizontal line of blocks of the color set by SETCOL 
on the low-resolution graphics display. Call HLINE with the vertical 
coordinate of the line in the accumulator, the leftmost horizontal 
coordinate in the Y register, and the rightmost horizontal 
coordinate in location $2C. HLINE returns with A and Y scrambled 
and X intact. 


HOME, $FC58 

HOME clears the display and puts the cursor in the upper-left 
corner of the screen. 

PLOT, $F800 


PLOT puts a single block of the color value set by SETCOL on the 
low-resolution display screen. Call PLOT with the vertical 
coordinate of the line in the accumulator, and its horizontal 
position in the Y register. PLOT returns with the accumulator 
scrambled, but X and Y intact. 


PRBL2, $F94A 


PRBL2 sends from 1 to 256 blanks to the standard output device. 
Upon entry, the X register should contain the number of blanks to 
send. If X = $00, then PRBLANK will send 256 blanks. 

PRBYTE, SFDDA 


PRBYTE sends the contents of the accumulator in hexadecimal to 
the current output device. The contents of the accumulator are 
scrambled. 

PRERR, $FF2D 


PRERR sends the word ERR, followed by a bell character, to the 
standard output device. On return, the accumulator is scrambled. 
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PRHEX, $FDE3 


PRHEX prints the lower nibble of the byte in the accumulator as a 
single hexadecimal digit. On return, the contents of the 
accumulator are scrambled. 


PRNTAX, $F941 


PRNTAX prints the contents of the A and X registers as a four-digit 
hexadecimal value. The accumulator contains the first byte printed, 
taband the X register contains the second. On return, the contents 
of the accumulator are scrambled. 


SCRN, $F871 


SCRN returns the color value of a single block on the low-resolution 
display. Call it with the vertical position of the block in the 
accumulator and the horizontal position in the Y register. The 
block’s color is returned in the accumulator. No other registers are 
changed. 


SETCOL, $F864 


SETCOL sets the color used for plotting in low-resolution graphics 
to the value passed in the acumulator. The colors and their values 
are listed in Table 2-6. 


VTABZ, $FC24 


VTABZ sets the cursor vertical position. Unlike setting the position 
at location $25, change of cursor position doesn’t wait until a 
carriage return character has been sent. 


VLINE, $F828 


VLINE draws a vertical line of blocks of the color set by SETCOL on 
the low-resolution display. Call VLINE with the horizontal 
coordinate of the line in the Y register, the top vertical coordinate 
in the accumulator, and the bottom vertical coordinate in 
location $2D. VLINE returns with the accumulator scrambled 


1/O firmware support 


Apple Ile video firmware conforms to the I/O firmware protocol of 
Apple II Pascal 1.1. However, it does not support windows other 
than the full 80-by-24 window in 80-column mode, and the full 40- 
by-24 window in 40-column mode. The video protocol table is 
shown in Table 3-9. 
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Table 3-9 
Slot 3 firmware protocol table 


Address Value Description 


$C30B $01 Generic signature byte of firmware cards. 

$C30C $88  80-column card device signature. 

$C30D $ii $C3ii is entry point of initialization routine (PINIT). 
$C30E $rr  — $C3rr is entry point of read routine (PREAD). 
$C30F $ww  $C3ww is entry point of write routine (PWRITE). 
$C310 $ss  $C3ss is entry point of the status routine 
(PSTATUS). 


PINIT, $C30D 

PINIT does the following: 

sets a full 80-column window 
sets 80STORE ($C001) 

sets 80COL ($CO0D) 


switches on ALTCHAR ($COOF) 
clears the screen; places cursor in upper-left corner 


DOO ea a 


displays the cursor 


PREAD, $C30E 


PREAD reads a character from the keyboard and places it in the 
accumulator with the high bit cleared. It also puts a zero in the 
X register to indicate IORESULT = GOOD. 


PWRITE, $C30F 

PWRITE should be called after placing a character in the 
accumulator with its high bit cleared. PWRITE does the following: 
O It turns the cursor off. 


O If the character in the accumulator is not a control character, it 
turns the high bit on for normal display or off for inverse display, 
displays it at the current cursor position, and advances the 
cursor. If the character at the end of a line, PWRITE does carriage 
return but not line feed. (See Table 3-10 for control character 
functions.) 


When PWRITE has completed this, it 

O tums the cursor back on (if it was not intentionally turned off) 

QO puts a zero in the X register TORESULT = GOOD) and returns to 
the calling program 
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Table 3-10 
Pascal video control functions 


Control- Hex Function performed 

Eore $05 Turns cursor on (enables cursor display) 
Forf $06 Turns cursor off (disables cursor display) 
Gorg $07 Sounds bell (beeps) 

Horh $08 Moves cursor left one column. If cursor was at 


beginning of line, moves it to end of 
preceding line 


Jorj $O0A Moves cursor down one row; scrolls if needed 

Kork $0B Clears to end of screen 

Lorl $0C Clears screen; moves cursor to upper-left of 
screen 

Morm $0D Moves cursor to column 0 

Norn $0E Displays subsequent characters in normal 


video (Characters already on display are 
unaffected.) 


Ooro $0F Displays subsequent characters in inverse 
video (Characters already on display are 
unaffected.) 


Vorv $16 Scrolls screen up one line; clears bottom line 

Worw $17 Scrolls screen down one line; clears top line 

Yory $19 Moves cursor to upper-left Ghome) position 
on screen 

ZOrz $1A Clears entire line that cursor is on 

lor\ $1C Moves cursor right one column; if at end of 


line, does Control-M 


lor] $1D Clears to end of the line the cursor is on, 
including current cursor position; does not 
move cursor 


Aor6 $1E GOTOxy: initiates a GOTOxy sequence; 
interprets the next two characters as x+32 and 
y+32, respectively 


$1F If not at top of screen, moves cursor up one 
line 
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PSTATUS, $C310 


A program that calls PSTATUS must first put a request code in the 
accumulator: either a 0, meaning “Ready for output?” or a 1, 
meaning “Is there any input?” PSTATUS returns with the reply in the 
carry bit: 0 (No) or 1 (Yes). 


PSTATUS returns with a 0 in the X register (ORESULT = GOOD), 


unless the request was not 0 or 1; then PSTATUS returns with a 3 in 
the X register (ORESULT = ILLEGAL OPERATION). 
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For information about these 
shared address spaces, see the 
section *“Bank-Switched 
Memory” in this chapter and the 
sections “Other Uses of I/O 
Memory Space” and “Expansion 
ROM Space” in Chapter 6. 


For details of the builf-in 1/O 
feature, refer to the descriptions 
in Chapters 2 and 3. 


For information about |/O 
operations with peripheral cards, 
refer to Chapter 6. 


The Apple Ie’s microprocessor can address 65,536 (64K) locations 
in memory. All of the Apple Ile’s RAM, ROM, and I/O devices are 
allocated locations in this 64K address range. Because each device 
or function requires a certain block of memory, there are more 
devices and functions than there are legal addresses, which means 
that the legal addresses must be shared. This sharing is 
accomplished through a technique called bank-switching, which is 
explained under the “Bank-Switched Memory” and “Auxiliary 
Memory and Firmware” sections in this chapter. 


All input and output in the Apple Ile is memory mapped. This 
means that all devices connected to the Apple Ile appear to be a set 
of memory locations to the computer. In this chapter, the I/O 
memory spaces are described simply as blocks of memory. 


Programmers often refer to the Apple Ile’s memory in 256-byte 
blocks called pages. One reason for this is that a one-byte address 
counter or index register can specify one of 256 different locations. 
Thus, page 0 consists of memory locations from 0 to 255 
(hexadecimal $00 to $FF), inclusive; page 1 consists of locations 
256 to 511 (hexadecimal $0100 to $01FF). Note that the page 
number is the high-order part of the hexadecimal address. Don’t 
confuse this kind of page with the display buffers in the Apple Ile, 
which are sometimes referred to as Page 1 and Page 2. 


Main memory map 


The map of the main memory address space in Figure 4-1 shows the 
functions of the major areas of memory. For more details on the 
1/O space from 48K to 52K ($C000 through $CFFF), refer to 
Chapter 2 and Chapter 6; the bank-switched memory in the 
memory space from 52K to 64K ($D000 through $FFFF) is described 
in the section “Bank-Switched Memory” later in this chapter. 
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Figure 4-1 
System memory map 
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RAM memory allocation 


As Figure 4-1 shows, the largest portion of the Apple Ile’s memory 
space is allocated to programmable storage (RAM). Figure 4-2 
shows the areas allocated to RAM. The main RAM memory extends 
from location 0 to location 49151 (hex $BFFF), and occupies 
pages 0 through 191 (hexadecimal $BF). There is also RAM storage 
in the bank-switched space from 53248 to 65535 (hexadecimal 
$D000 to $FFFF), described in the section “Bank-Switched 
Memory” later in this chapter, and auxiliary RAM, described in the 
section “Auxiliary Memory and Firmware” later in this chapter. 


Page 2 
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Page 2 | Text and Low-Resolution 
Page 1 | Graphics Display Buffers 


+ —— Reserved Pages 


Figure 4-2 
RAM allocation map 
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Important 


Reserved memory pages 


Most of the Apple Ile’s RAM is available for storing your programs 
and data. However, a few RAM pages are reserved for the use of the 
Monitor firmware and the BASIC interpreters. The reserved pages 
are described in the following sections. 


The system does not prevent your using these pages, but if you 


do use them, you must be careful not to disturb the system 


data they contain, or you will cause the system to malfunction. 


Page zero 


Several of the 65C02 microprocessor’s addressing modes require 
the use of addresses in page zero, also called zero page. The 
Monitor, the BASIC interpreters, DOS 3.3, and ProDOS all make 
extensive use of page zero. 


To use indirect addressing in your assembly-language programs, 
you must store base addresses in page zero. At the same time, you 
must avoid interfering with the other programs that use page 
zero—the Monitor, the BASIC interpreters, and the disk operating 
systems. One way to avoid conflicts is to use only those page-zero 
locations not already used by other programs, Tables 4-1 through 
4-5 show the locations in page zero used by the Monitor, Applesoft 
BASIC, Integer BASIC, DOS 3.3, and ProDOS. 


As you can see from the tables, page zero is pretty well used up, 
except for a few bytes here and there. It’s hard to find more than 
one or two bytes that aren’t used by BASIC, ProDOS, the Monitor, 
or DOS. Rather than trying to squeeze your data into an unused 
corner, you may prefer a safer alternative: save the contents of part 
of page zero, use that part, then restore the previous contents 
before you pass control to another program. 
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For more information about links, 


see the section “Changing the 
Standard 1/O Links” in 
Chapter 6. 


See Chapter 6 for information 
on the memory locations that 


are reserved for peripheral cards. 


The 65C02 stack 


The 65C02 microprocessor uses page 1 as the stack—the place 
where subroutine return addresses are stored—in last-in, first-out 
sequence. Many programs also use the stack for temporary storage 
of the registers (via push and pull operations). You can do the 
same, but you should use it sparingly. The stack pointer is eight bits 
long, so the stack can hold only 256 bytes of information at a time. 
When you store the 257th byte in the stack, the stack pointer repeats 
itself, or wraps around, so that the new byte replaces the first byte 
stored, which is now lost. This writing over old data is called stack 
overflow, and when it happens, the program continues to run 
normally until the lost information is needed, whereupon the 
program terminates catastrophically. 


The input buffer 


The GETILN input routine, which is used by the Monitor and the 
BASIC interpreters, uses page 2 as its keyboard-input buffer. The 
size of this buffer sets the maximum size of input strings. (Applesoft 
uses only the first 237 bytes, although it permits you to type in 256 
characters.) If you know that you won't be typing any long input 
strings, you can store temporary data at the upper end of page 2. 


Link-address storage 


The Monitor, ProDOS, and DOS 3.3 all use the upper part of page 3 
for link addresses or vectors. 


BASIC programs sometimes need short machine-language 
routines. These routines are usually stored in the lower part of 
page 3. 


The display buffers 


The primary text and low-resolution-graphics display buffer 
occupies memory pages 4 through 7 Cocations 1024 through 2047, 
hexadecimal $0400 through $07FF). This entire 1024-byte area is 
called text Page 1, and it is not usable for program and data 
storage. There are 64 locations in this area that are not displayed on 
the screen; these locations are reserved for use by the peripheral 
cards. 
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For more information about the 
display buffers, see the section 
“Video Display Pages” in 
Chapter 2. 


Text Page 2, the alternate text and low-resolution-graphics display 
buffer, occupies memory pages 8 through 11 Cocations 2048 
through 3071, hexadecimal $0800 through $0BFF). Most programs 
do not use Page 2 for displays, so they can use this area for program 
or data storage. 


The primary high-resolution-graphics display buffer, called high- 
resolution Page 1, occupies memory pages 32 through 63 
Cocations 8192 through 16383, hexadecimal $2000 through $3FFF). 
If your program doesn’t use high-resolution graphics, this area is 
usable for programs or data. 


High-resolution Page 2 occupies memory pages 64 through 95 
(locations 16384 through 24575, hexadecimal $4000 through 
$5FFF). Most programs use this area for program or data storage. 


The primary double high-resolution-graphics display buffer, called 
double high-resolution Page 1, occupies memory pages 32 through 
63 (locations 8192 through 16383, hexadecimal $2000 through 
$3FFF) in both main and auxiliary memory. If your program 
doesn’t use high-resolution or double high-resolution graphics, 
this area of main memory is usable for programs or data. 


Table 4-1 
Monitor zero-page use 


Low nibble of address 
High nibble 


of address $0 $1 $2 $3 $4 $5 $6 $7 $8 $9 SA $B $C SD SE $F 


$00 

$10 e* 
$20 
$30 
$40 
$50 
$60 
$70 
$80 
$90 
$A0 
$BO 
$CcO0 
$D0 
$E0 
$FO 


* Byte used in original Apple Ile ROMs, now free 
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Table 4-2 


Applesoft zero-page use 


High nibble 
of address 


$00 
$10 
$20 
$30 
$40 
$50 
$60 
$70 
$80 
$90 
$A0 
$BO 
$co 
$D0 
$EO 
$FO 


Table 4-3 


Integer BASIC zero-page 


High nibble 
of address 


$00 
$10 
$20 
$30 
$40 
$50 
$60 
$70 
$80 
$90 
$A0 
$BO 
$Cco 
$D0 
$E0 
$FO 
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$0 $1 
ee 
ee 
ee 
ee 


$2 


$3 $4 


$0 $1 $2 $3 
e ee @ 
eo eee 
eo ee e@ 
oe @ e@ 


Low nibble of address 


$7 $8 $9 $A $B $C SD SE 


$5 $6 
° 
ee 
ee 
ee 
eo. 
ee 
eo. 
ee 
ee 
oe 
ee 
oe 


use 


$4 $5 $6 $7 $8 $9 $A $B $C $D SE 


eeeee#eee @ 


Low nibble of address 


$F 


SF 


Table 4-4 
DOS 3.3 zero-page use 


Low nibble of address 
High nibble | — a 
of address $0 $1 $2 $3 $4 $5 $6 $7 $8 $9 $A $B $C $D $E $F 


$00 

$10 

$20 e oe ee «© « 
$30 eoeeee e e 
$40 oo e ee © © @ @ eee 
$50 

$60 eee e e 
$70 ° 

$80 

$90 

$A0 ° 
$BO ° 

$CO eee e@ 

$D0 e 

$EO 

$FO 


Table 4-5 
ProDOS MLI and disk-driver zero-page use 


Low nibble of address 
igh nibble: a es 
of address $0 $1 $2 $3 $4 $5 $6 $7 $8 $9 $A $B $C $D SE $F 


$00 eo. 

$10 

$20 

$30 eee © @ «@ 
$40 oeee e ee © © © © © © © © 
$50 

$60 

$70 

$80 

$90 

$A0 

$BO 

$CO 

$D0 

$EO 

$FO 
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Bank-switched memory 


The memory address space from 52K to 64K (hexadecimal $D000 
through $FFFF) is doubly allocated: it is used for both ROM and 
RAM. The 12K bytes of ROM (read-only memory) in this address 
space contain the Monitor and the Applesoft BASIC interpreter. 
Alternatively, there are 16K bytes of RAM in this space. The RAM is 
normally used for storing either the Integer BASIC interpreter or 
part of the Pascal Operating System (purchased separately). 


You may be wondering why this part of memory has such a split 
personality. Some of the reasons are historical: the Apple Ile is able 
to run software written for the Apple II and Apple II Plus because it 
uses this part of memory in the same way they do. It’s convenient to 
have the Applesoft interpreter in ROM, but the Apple Ile, like an 
Apple II with a language card, is also able to use that address space 
for other things when Applesoft is not needed. 


You may also be wondering how 16K bytes of RAM are mapped into 
only 12K bytes of address space. The usual answer is that it’s done 
with mirrors, and that isn’t a bad analogy: the 4K-byte address 
space from 52K to 56K (hexadecimal $D000 through $DFFF) is used 
twice. 


Switching different blocks of memory into the same address space is 
called bank switching. There are actually two examples of bank 
switching going on here: first, the entire address space from 52K to 
64K ($D000 through $FFFF) is switched between ROM and RAM, 
and second, the address space from 52K to 56K ($D000 to $DFFF) is 
switched between two different blocks of RAM. 





Figure 4-3 
Bank-switched memory map 
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Warning 


Setting bank switches 


You switch banks of memory in the same way you switch other 
functions in the Apple Ile: by using soft switches. Read operations 
to these soft switches do three things: select either RAM or ROM in 
this memory space; enable or inhibit writing to the RAM; and select 
the first or second 4K-byte bank of RAM in the address space $D000 
to $DFFF. 


Do not use these switches without careful planning. Careless 
switching between RAM and ROM is almost certain to have 
catastrophic effects on your program. 


Table 4-6 shows the addresses of the soft switches for enabling all 
combinations of reading and writing in this memory space. All of 
the hexadecimal values of the addresses are of the form $C08x. 
Notice that several addresses perform the same function: this is 
because the functions are activated by single address bits. For 
example, any address of the form $C08x with a 1 in the low-order 
bit enables the RAM for writing. Similarly, bit 3 of the address 
selects which 4K block of RAM to use for the address space $D000- 
$DFFF; if bit 3 is 0, the first bank of RAM is used, and if bit 3 is 1, 
the second bank is used. 


When RAM is not enabled for reading, the ROM in this address 
space is enabled. Even when RAM is not enabled for reading, it can 
still be written to if it is write-enabled. 


When you turn power on or reset the Apple Ile, it initializes the bank 
switches for reading the ROM and writing the RAM, using the 
second bank of RAM. Note that this is different from the reset on the 
Apple II Plus, which didn’t affect the bank-switched memory (the 
language card). On the Apple Ile, you can’t use the reset vector to 
return control to a program in bank-switched memory, as you could 
on the Apple II Plus. 


Reset with Integer BASIC: When you are using Integer BASIC 
on the Apple Ile, reset works correctly, restarting BASIC with 
your program intact. This happens because the reset vector 
transfers control to DOS, and DOS resets the switches for the 
current version of BASIC. 
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Table 4-6 
Bank select switches 


Name Action 


R 


RR 


RDBNK2 R7 


RDLCRAM ~ R7/ 
ALTZP WwW 


ALTZP W 


RDALTZP R7 


Hex 


$C080 


$C081 


$C082 


$C083 


$C088 


$C089 


$CO8A 


$CO8B 


$C011 


$C012 
$C008 


$C009 


$C016 


Function 
Read RAM; no write; use 
$D000 bank 2. 


Read ROM; write RAM; use 
$D000 bank 2. 


Read ROM; no write; use 
$D000 bank 2. 


Read and write RAM; use 
$D000 bank 2. 


Read RAM; no write; use 
$D000 bank 1. 


Read ROM; write RAM; use 
$D000 bank 1. 


Read ROM; no write; use 
$D000 bank 1. 


Read and write RAM; use 
$D000 bank 1. 


Read whether $D000 
bank 2 (1) or bank 1 (0). 


Reading RAM (1) or ROM (0). 


Off: use main bank, page 0 
and page 1. 

On: use auxiliary bank, page 0 
and page 1. 


Read whether auxiliary (1) or 
main (0) bank. 


Note: R means read the location, W means write anything to the location, 
R/W means read or write, and R7 means read the location and then check 


bit 7. 


“ Reading and writing to RAM banks: You can’t read one RAM 
bank and write to the other; if you select either RAM bank for 
reading, you get that one for writing as well. 
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AD 
AD 
AQ 
85 
AQ 
85 
20 


AD 
20 


AD 
AQ 
E6 
20 


AD 
E6 
AQ 
20 


AD 
AD 
E6 
E6 
AQ 
20 


83 
83 
DO 
O1 
FF 
02 
97 


8B 
97 


83 
80 
10 
58 


80 
10 
01 
58 


8B 
8B 
OE 
10 
08 


58° 


co 
co 


C9 


co 
co 


co 


co 


co 


cg 


co 
co 


cg 


LDA 
LDA 
LDA 
STA 
LDA 
STA 
JSR 


LDA 
JSR 


LDA 
LDA 
INC 
JSR 


LDA 
INC 
LDA 
JSR 


LDA 
LDA 
INC 
INC 
LDA 
JSR 


& Reading RAM and ROM: You can’t read from ROM in part of 
the bank-switched memory and read from RAM in the rest: 
specifically, you can’t read the Monitor in ROM while reading 
bank-switched RAM. If you want to use the Monitor firmware 
with a program in bank-switched RAM, copy the Monitor from 
ROM (locations $F800 through $FFCB) into bank-switched 
RAM. You can’t do this from Pascal or ProDOS. 


To see how to use these switches, look at the following section of an 
assembly-language program: 


$c083 *SELECT 2ND 4K BANK & READ/WRITE 
$C083 *BY TWO CONSECUTIVE READS 

#$D0 *SET UP... 

BEGIN *,.. NEW... 

#SFF *,..MAIN-MEMORY... 

END *,..POINTERS... 

RAMTST *,..FOR 12K BANK 

$CO8B *SELECT 1ST 4K BANK 

RAMTST *USE ABOVE POINTERS 

$co8s *SELECT 1ST BANK & WRITE PROTECT 
#$80 

TSTNUM 

WPTSINIT 

$c080 *SELECT 2ND BANK & WRITE PROTECT 
TSTNUM 

#PAT12K 

WPTSINIT 

$CO8B *SELECT iST BANK & READ/WRITE 
$CO8B *BY TWO CONSECUTIVE READS 

RWMODE *FLAG RAM IN READ/WRITE 

TSTNUM : 

#PAT4K 

WPTSINIT 


The LDA instruction, which performs a read operation to the 
specified memory location, is used for setting the soft switches. The 
unusual sequence of two consecutive LDA instructions performs the 
two consecutive reads that write-enable this area of RAM; in this 
case, the data that are read are not used. 
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Reading bank switches 


You can read which language card bank is currently switched in by 
reading the soft switch at $C011. You can find out whether the 
language card or ROM is switched in by reading $C012. The only 
way that you can find out whether the language card RAM is write- 
enabled or not is by trying to write some data to the card’s RAM 
space. 


Auxiliary memory and firmware 


By installing an optional card in the auxiliary slot, you can add 
more memory to the Apple Ile. One such card is the Apple IIe 80- 
Column Text Card, which has 1K bytes of additional RAM for 
expanding the text display from 40 columns to 80 columns. 


Another 80-column text card, the Apple Ile Extended 80-Column 
Text Card, has 64K of additional RAM. A 1K-byte area of this 
memory serves the same purpose as the memory on the 80-Column 
Text Card: expanding the text display to 80 columns. The other 63K 
bytes can be used as auxiliary program and data storage. If you use 
only 40-column displays, the entire 64K bytes is available for 
programs and data. The Extended 80-Column Text Card is installed 
in the extended keyboard Ile and shipped with later models of the 
enhanced Ile. 


Warning Do not attempt to use the auxiliary memory from a BASIC 
program. The BASIC Interpreter uses several areas In main RAM, 
including the stack and the zero page. If you switch to 
auxiliary memory In these areas, the BASIC Interpreter fails and 
you must reset the system and start over. 


As you can see by studying the memory map in Figure 4-4, the 
auxiliary memory is broken into two large sections and one small 
one. The largest section is switched into the memory address space 
from 512 to 49151 ($0200 through $BFFF). This space includes the 
display buffer pages: as described in the section “Text Modes” in 
Chapter 2, space in auxiliary memory is used for one half of the 80- 
column text display. You can switch to the auxiliary memory for this 
entire memory space, or you can switch just the display pages: see 
the next section, “Memory Mode Switching.” 
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Soft switches: If the only reason you are using auxiliary memory 
is for the 80-column display, note that you can store into the 
display page in auxiliary memory by using the 80STORE and 
PAGE2 soft switches described in the section “Display Mode 
Switching” in Chapter 2. 


The other large section of auxiliary memory is switched into the 
memory address space from 52K to 64K ($D000 through $FFFF). 
This memory space and the switches that control it are described 
earlier in this chapter in the section “Bank-Switched Memory.” If 
you use the auxiliary RAM in this space, the soft switches have the 
same effect on the auxiliary RAM that they do on the main RAM: the 
bank switching is independent of the auxiliary-RAM switching. 

















Main 
Bank- 

Switched 
RAM 


High-Resolution 
3FFF Graphics Display Buffers 


2000 


Text and Low-Resolution 
Graphics Display Buffers 


0000 Stack and Zero Page —»> 


Figure 4-4 
Memory map with auxilliary memory 
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Warning 


% Bank switches: Note that the soft switches for the bank-switched 
mémory, described in the previous section, do not change 
when you switch to auxiliary RAM. In particular, if ROM is 
enabled in the bank-switched memory space before you switch 
to auxiliary memory, the ROM will still be enabled after you 
switch. Any time you switch the bank-switched section of 
auxiliary memory in and out, you must also make sure that the 
bank switches are set properly. 


When you switch in the auxiliary RAM in the bank-switched space, 
you also switch the first two pages, from 0 to 511 ($0000 through 
$01FF). This part of memory contains page zero, which is used for 
important data and base addresses, and page one, which is the 
65C02 stack. The stack and zero page are switched this way so that 
system software running in the bank-switched memory space can 
maintain its own stack and zero page while it manipulates the 48K 
address space (from $0200 to $BFFF) in either main memory or 
auxiliary memory. 


Memory mode switching 


Switching the 48K section of memory is performed by two soft 
switches: the switch named RAMRD selects main or auxiliary 
memory for reading, and the one named RAMWRT selects main or 
auxiliary memory for writing. As shown in Table 4-7, each switch 
has a pair of memory locations dedicated to it, one to select main 
memory, and the other to select auxiliary memory. Enabling the 
read and write functions independently makes it possible for a 
program whose instructions are being fetched from one memory 
space to store data into the other memory space. 


Do not use these switches without careful planning. Careless 
switching between main and auxiliary memories is almost 
certain to have catastrophic effects on the operation of the 
Apple lle. For example, if you switch to auxiliary memory with 
no card In the slot, the program that is running will stop and 
you will have to reset the Apple lle and start over. 


Chapter 4: Memory Organization 


The next section, “Auxiliary- 
Memory Subroutines,” describes 
firmware that you can call to 
help you switch between main 
and auxiliary memory. 


Writing to the soft switch at location $C003 turns RAMRD on and 
enables auxiliary memory for reading; writing to location $C002 
turns RAMRD off and enables main memory for reading. Writing to 
the soft switch at location $C005 turns RAMWRT on and enables the 
auxiliary memory for writing; writing to location $C004 turns 
RAMWRT off and enables main memory for writing. By setting 
these switches independently, you can use any of the four 
combinations of reading and writing in main or auxiliary memory. 


Auxiliary memory corresponding to text Page 1 and high- 
resolution graphics Page 1 can be used as part of the address space 
from $0200 to $BFFF by using RAMRD and RAMWRT as described 
above. These areas in auxiliary RAM can also be controlled 
separately by using the switches described in the section “Display 
Mode Switching” in Chapter 2. Those switches are named 
80STORE, PAGE2, and HIRES. 


As shown in Table 4-7, the 80STORE switch functions as an enabling 
switch: with it on, the PAGE2 switch selects main memory or 
auxiliary memory. With the HIRES switch off, the memory space 
switched by PAGE2 is the text Page 1, from $0400 to $07FF; with 
HIRES on, PAGE2 switches both text Page 1 and high-resolution 
graphics Page 1, from $2000 to $3FFF. 


If you are using both the auxiliary-RAM control switches and the 
auxiliary-display-page control switches, the display-page control 
switches take priority: if SOSTORE is off, RAMRD and RAMWRT work 
for the entire memory space from $0200 to $BFFF, but if 80STORE is 
on, RAMRD and RAMWRT have no effect on the display page. 
Specifically, if 80STORE is on and HIRES is off, PAGE2 controls text 
Page 1 regardless of the settings of RAMRD and RAMWRT. Likewise, 
if 80STORE and HIRES are both on, PAGE2 controls both text 

Page 1 and high-resolution graphics Page 1, again regardless of 
RAMRD and RAMWRT. 


A single soft switch named ALTZP (for alternate zero page) switches 
the bank-switched memory and the associated stack and zero page 
area between main and auxiliary memory. As shown in Table 4-7, 
writing to location $C009 turns ALTZP on and selects auxiliary- 
memory stack and zero page; writing to the soft switch at location 
$C008 turns ALTZP off and selects main-memory stack and zero 
page for both reading and writing. 
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Table 4-7 


Auxiliary-memory select switches 


Location 
Name Function Hex Decimal Notes 
RAMRD Read auxiliary memory $C003 = 49155. -16381 Write 
Read main memory $C002 49154 -16382 Write 
Read RAMRD switch $C013 49171 _-16365 Read 
RAMWRT Write auxiliary memory $C005 49157 -16379 Write 
Write main memory $C004 49156 -16380 Write 
Read RAMWRT switch $C014. 49172 -16354 Read 
80STORE On: access display page $Cc001 49153-16383 Write 
Off: use RAMRD, RAMWRT $C000 = 49152 -16384 Write 
Read 80STORE switch $C018 49176 -16360 Read 
PAGE2 Page 2 on (aux. memory) $C055 49237 -16299 . 
Page 2 off (main memory) $C054 49236 -16300 * 
Read PAGE2 switch $C01C 49180 -16356 Read 
HIRES On: access high-res pages $C057 49239 -16297 t 
Off: use RAMRD, RAMWRT $C056 49238 -16298 Tt 
Read HIRES switch $CO1D 49181 -16355 Read 
ALTZP Aux. stack & zero page $C009 =-_- 49161 - 16373 Write 
Main stack & zero page $C008 49160 -16374 Write 
Read ALTZP switch $C016 = 49174-16352 Read 


“When 80STORE is on, the PAGE2 switch selects main or auxiliary display memory. 
+ When 80STORE is on, the HIRES switch enables you to use the PAGE2 switch to switch between the high- 
resolution Page 1 area in main memory or auxiliary memory. 


When these switches are on, 
auxiliary memory Is being used; 
when they are off, main 
memory is being used. 


There are three more locations associated with the auxiliary- 
memory switches. The high-order bits of the bytes you read at these 
locations tell you the settings of the three soft switches described 
above. The byte you read at location $C013 has its high bit set to 1 if 
RAMRD is on (auxiliary memory is read-enabled), or 0 if RAMRD is 
off (the 48K block of main memory is read-enabled). The byte at 
location $C014 has its high bit set to 1 if RAMWRT is on (auxiliary 
memory is write-enabled), or 0 if RAMWRT is off (the 48K block of 
main memory is write-enabled). The byte at location $C016 has its 
high bit set to 1 if ALTZP is on (the bank-switched area, stack, and 
zero page in the auxiliary memory are selected), or 0 if ALTZP is off 
(these areas in main memory are selected). 
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Important 


“ Sharing memory: In order to have enough memory locations 
for all of the soft switches and remain compatible with the 
Apple II and Apple II Plus, the soft switches listed in Table 4-7 
share their memory locations with the keyboard functions listed 
in Table 2-1. The operations—read or write—shown in 
Table 4-7 for controlling the auxiliary memory are just the ones 
that are not used for reading the keyboard and clearing the 
strobe. 


Auxiliary-memory subroutines 


If you want to write assembly-language programs that use auxiliary 
memory but you don’t want to manage the auxiliary memory 
yourself, you can use the built-in auxiliary-memory subroutines. 
These subroutines make it possible to use the auxiliary memory 
without having to manipulate the soft switches described in the 
previous section. 


The subroutines described below make It easier to use auxiliary 
memory, but they do not protect you from errors. You still have 
to plan your use of auxiliary memory to avoid catastrophic 
effects on your program. 


You use these built-in subroutines the same way you use the I/O 
subroutines described in Chapter 3: by making subroutine calls to 
their starting locations. Those locations are shown in Table 4-8. 


Table 4-8 

48K RAM transfer routines 

Name Action Hex Function 

AUXMOVE JSR $C311 Moves data blocks between 
main and auxiliary 
48K memory 

XFER JMP $C314 Transfers program control 
between main and auxiliary 
48K memory 
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Warning 


Moving data to auxiliary memory 


In your assembly-language programs, you can use the built-in 
subroutine named AUXMOVE to copy blocks of data from main 
memory to auxiliary memory or from auxiliary memory to main 
memory. Before calling this routine, you must put the data 
addresses into byte pairs in page zero and set the carry bit to select 
the direction of the move—main to auxiliary or auxiliary to main. 


Don't try to use AUXMOVE to copy data in page zero or page 
one (the 65C02 stack) or in the bank-switched memory ($D000- 
SFFFF). AUXMOVE uses page zero all during the copy, so it 


can‘t handle moves in the memory space switched by ALTZP. 


The pairs of bytes you use for passing addresses to this subroutine 
are called Al, A2, and A4, and they are used for parameter passing 
by several of the Apple IIe’s built-in routines. The addresses of 
these byte pairs are shown in Table 4-9. 


Table 4-9 
Parameters for AUXMOVE routine 


Name Location Parameter passed 


Carry 1 = Move from main to auxiliary memory 
0 = Move from auxiliary to main memory 
AIL $3C Source starting address, low-order byte 
A1H $3D Source starting address, high-order byte 
A2L $3E Source ending address, low-order byte 
A2H $3F Source ending address, high-order byte 
A4L $42 Destination starting address, low-order byte 
A4H $43 Destination starting address, high-order byte 


Note: The X, Y, and A registers are preserved by AUXMOVE. 


Put the addresses of the first and last bytes of the block of memory 
you want to copy into Al and A2. Put the starting address of the 
block of memory you want to copy the data to into A4. 


The AUXMOVE routine uses the carry bit to select the direction to 
copy the data. To copy data from main memory to auxiliary 
memory, set the carry bit; to copy data from auxiliary memory to 
main memory, clear the carry bit. 


When you make the subroutine call to AUXMOVE, the subroutine 
copies the block of data as specified by the A byte pairs and the 
carry bit. When it is finished, the accumulator and the X and Y 
registers are just as they were when you called AUXMOVE. 
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Warning 


Transferring control to auxiliary memory 


You can use the built-in routine named XFER to transfer control to 
and from program segments in auxiliary memory. You must set up 
three parameters before using XFER: the address of the routine you 
are transferring to, the direction of the transfer (main to auxiliary or 
auxiliary to main), and which page zero and stack you want to use. 


Table 4-10 
Parameters for XFER routine 
Name 
or location Parameter passed 
Carry 1 = Transfer from main to auxiliary memory 
0 = Transfer from auxiliary to main memory 
Overflow 1 = Use page zero and stack in auxiliary memory 
0 = Use page zero and stack in main memory 
$03ED Program starting address, low-order byte 
$03EE Program starting address, high-order byte 


Note: The X, Y, and A parameters are preserved by XFER. 


Put the transfer address into the two bytes at locations $03ED and 
$03EE, with the low-order byte first, as usual. The direction of the 
transfer is controlled by the carry bit: set the carry bit to transfer to 
a program in auxiliary memory; clear the carry bit to transfer to a 
program in main memory. Use the overflow bit to select which page 
zero and stack you want to use: clear the overflow bit to use the main 
memory; set the overflow bit to use the auxiliary memory. 


After you have set up the parameters, pass control to the XFER 
routine by a jump instruction, rather than a subroutine call. XFER 
saves the accumulator and the transfer address on the current stack, 
then sets up the soft switches for the parameters you have selected 
and jumps to the new program. 


It is the programmer's responsibility to save the current stack 
pointer at $0100 in auxiliary memory and the alternate stack 
pointer at $0101 in auxiliary memory before calling XFER and to 
restore them after regaining control. Failure to do so will cause 
program errors. 


Auxiliary memory and firmware 93 


For information about the |/O 
links, see the section “Changing 
the Standard I/O Links” In 
Chapter 6. 


For more information about 
peripheral-card ROM, see the 
section “Peripheral-Card ROM 
Space” in Chapter 6. 


The reset routine 


To put the Apple Ile into a known state when it has just been turned 
on or after a program has malfunctioned, there is a procedure 
called the reset routine. The reset routine is built into the Apple Le’s 
firn.ware, and it is initiated any time you turn power on or press 
Reset while holding down Control. The reset routine puts the 

Apple Ile into its normal operating mode and restarts the resident 
program. 


When you initiate a reset, hardware in the Apple Ile sets the 
memory-controlling soft switches to normal: main board RAM and 
ROM are enabled, and, if there is an 80-column text card in the 
auxiliary slot, expansion slot 3 is allocated to the built-in 80- 
column firmware. Auxiliary RAM is disabled and the bank-switched 
memory space is set up to read from ROM and write to RAM, using 
the second bank at $D000. 


The reset routine sets the display-controlling soft switches to display 
40-column text Page 1 using the primary character set, then sets the 
window equal to the full 40-column display, puts the cursor at the 
bottom of the screen, and sets the display format to normal. 


The reset routine sets the keyboard and display as the standard input 
and output devices by loading the standard I/O links. It turns 
annunciators 0 and 1 off and annunciators 2 and 3 on, clears the 
keyboard strobe, turns off any active peripheral-card ROM, and 
outputs a bell (tone). 


The Apple Ile has three types of reset: power-on reset, also called 
cold-start reset; warm-start reset; and forced cold-start reset. 
The procedure described above is the same for any type of reset. 
What happens next depends on the reset vector. The reset routine 
checks the reset vector to determine whether it is valid or not, as 
described later in this chapter in the section “The Reset Vector.” If 
the reset was caused by turning the power on, the vector will not be 
valid, and the reset routine will perform the cold-start procedure. If 
the vector is valid, the routine will perform the warm-start 
procedure. 
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For more information about 
ProDOS and the startup 
procedure, see the ProDOs 
Technical Reference Manual. 


Important 


The cold-start procedure 


If the reset vector is not valid, either the Apple Ile has just been 
turned on or something has caused memory contents to be 
changed. The reset routine clears the display and puts the string 
“Apple //e” (“Apple ] [” on an original Ile) at the top of the 
display. It loads the reset vector and the validity-check byte as 
described below, then starts checking the expansion slots to see if 
there is a disk drive controller card in one of them, starting with 
slot 7 and working down. 


If the reset routine finds a controller card, it initiates the startup 
(bootstrap) routine that resides in the controller card’s firmware. 
The startup routine then loads DOS or ProDOS from the disk in 
drive 1. When the operating system has been loaded, it displays 
other messages on the screen. If there is no disk in the disk drive, 
the drive motor just keeps spinning until you press Control-Reset. 


If the reset routine doesn’t find a controller card, or if you press 
Control-Reset again before the startup procedure has been 
completed, the reset routine will continue without using the disk, 
and pass control to the built-in Applesoft interpreter. 


The warm-start procedure 


Whenever you press Control-Reset when the Apple Ile has already 
completed a cold-start reset, the reset vector is still valid and it is 
not necessary to reinitialize the entire system. The reset routine 
simply uses the vector to transfer control to the resident program, 
which is normally the built-in Applesoft interpreter. If the resident 
program is indeed Applesoft, your Applesoft program and 
variables are still intact. If you are using DOS, it is the resident 
program and it restarts either Applesoft or Integer BASIC, 
whichever you were using when you pressed Control-Reset. 


A program In bank-switched RAM cannot use the reset vector 


to regain control after a reset, because the Apple lle hardware 
enables ROM in the bank-switched memory space. If you are 
using Integer BASIC, which Is in the bank-switched RAM, you 
are also using DOS, and it is DOS that controls the reset vector 
and restarts BASIC. 
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Forced cold start 


If a program has loaded the reset vector to point to the beginning of 
the program, as described in the next section, pressing Control- 
Reset causes a warm-start reset that uses the vector to transfer 
control to that program. If you want to stop such a program without 
turning the power off and on, you can force a cold-start reset by 
holding down Open Apple and Control, then pressing and 
releasing Reset. 


“ Unconditional restart: When you want to stop a program 
unconditionally—for example, to start up the Apple Ile with 
some other program—you should use the forced cold-start 
reset, Open Apple-Control-Reset, instead of turning the power 
off and on. 


Whenever you press Control-Reset, firmware in the Apple Ile always 
checks to see whether either Apple key is down. If the Solid Apple 
key (or Option key, in the extended keyboard Ile) is down, with or 
without the Open Apple key, the firmware performs the self-test 
described later in this chapter. If only the Open Apple key is down, 
the firmware starts a forced cold-start reset. First, it destroys the 
program or data in memory by writing two bytes of arbitrary data 
into each page of main RAM. The two bytes that get written over in 
page 3 are the ones that contain the reset vector. The reset routine 
then performs a normal cold-start reset. 


The reset vector 


When you reset the Apple Ile, the reset routine transfers control to 
the resident program by means of an address stored in page 3 of 
main RAM. This address is called a vector because it directs 
program control to a specified destination. There are several other 
vector addresses stored in page 3, as shown in Table #11, 
including the interrupt vectors described in the section “Interrupts 
on the Enhanced Apple Ile” in Chapter 6, and the ProDOS and 
DOS vectors described in the ProDOS Technical Reference 
Manual and the Apple II DOS Programmer's Manual. 
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The cold-start reset routine stores the starting address of the built-in 
Applesoft interpreter, low-order byte first, in the reset vector 
address at locations 1010 and 1011 (hexadecimal $03F2 and $03F3). 
It then stores a validity-check byte, also called the power-up byte, at 
location 1012 (hexadecimal $03F4). The validity-check byte is 
computed by performing an exclusive-OR of the second byte of the 
vector with the constant 165 (hexadecimal $A5). Each time you 
reset the Apple Ile, the reset routine uses this byte to determine 
whether the reset vector is still valid. 


You can change the reset vector so that the reset routine will transfer 
control to your program instead of to the Applesoft interpreter. For 
this to work, you must also change the validity-check byte to the 
exclusive-OR of the high-order byte of your new reset vector with 
the constant 165 ($A5). If you fail to do this, then the next time you 
reset the Apple Ile the reset routine will determine that the reset 
vector is invalid and perform a cold-start reset, eventually 
transferring control to the disk startup routine or to Applesoft. 


The reset routine has a subroutine that generates the validity-check 
byte for the current reset vector. You can use this subroutine by 
doing a subroutine call to location -1169 (hexadecimal $FB6F). 
When your program finishes, it can return the Apple Ile to normal 
operation by restoring the original reset vector and again calling 
the subroutine to fix up the validity-check byte. 


Table 4-11 

Page 3 vectors 

Vector 

address Vector function 

$3FO$3F1 Address of the subroutine that handles BRK 
requests (normally $59, $FA) 

$3F2$3F3 Reset vector (see text) 

$3F4 Power-up byte (see text) 

$3F5$3F6$3F7 Jump instruction to the subroutine that handles 
Applesoft & commands (normally $4C, $58, 
$FF) 

$3F8$3F9$3FA Jump instruction to the subroutine that handles 
user Control-Y commands 

$3FB$3FC$3FD Jump instruction to the subroutine that handles 
nonmaskable interrupts 

$3FE$3FF Interrupt vector (address of the subroutine that 


handles interrupt requests 
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Warning 


Automatic self-test 


If you reset the Apple Ile by holding down Solid Apple and Control 
while pressing and releasing Reset, the reset routine will start 
running the built-in self-test. Successfully running this test assures 
you that the Apple Ile is operational. 


The self-test routine tests the Apple lle’s programmable memory 


by writing and then reading It. All programs and data in 
programmable memory when you run the self-test are 
destroyed. 


The self-test takes several seconds to run. The screen will display 
some patterns in low-resolution mode that will change rapidly just 
before the self-test finishes. If the test finishes normally, the 
Apple Ie displays System OK and waits for you to restart the 
system. 


If you have been running a program, some soft switches might be on 
when you run the self-test. If this happens, the self-test will display a 
message such as 


IOU FLAG ES: 1 


Turn the power off for several seconds, then turn it back on and 
run the self-test again. If it still fails, there is really something 
wrong; to get it corrected, contact your authorized Apple dealer for 
service. 
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The starting addresses for all of 
the standard subroutines are 
listed in Appendix B. 


The System Monitor is a set of subroutines in the Apple Ile 
firmware. The Monitor provides a standard interface to the built-in 
I/O devices described in Chapter 2. The I/O subroutines described 
in Chapter 3 are part of the System Monitor. 


ProDOS, DOS 3.3, and the BASIC interpreters use these 
subroutines by direct calls to their starting locations, as described 
for the I/O subroutines in Chapter 3. 


If you wish, you can call the standard subroutines from your 
programs in the same fashion. 


You can perform most of the Monitor functions directly from the 
keyboard. This chapter tells you how to use the Monitor to 


0 look at one or more memory locations 
0 change the contents of any location 


O write programs in machine language to be executed directly by 
the Apple Ile’s microprocessor 


Oo 


save blocks of data and programs onto cassette tape and read 
them back in again 


move and compare blocks of memory 
search for data bytes and ASCII characters in memory 
invoke other programs from the Monitor 


ol oO DD Ba 


invoke the Mini-Assembler 


Invoking the Monitor 


The System Monitor starts at memory location $FF69 (decimal 
65385 or -15D. To invoke the Monitor, you make a CALL statement 
to this location from the keyboard or from a BASIC program. When 
the Monitor is running, its prompt character, an asterisk (*), 
appears on the left side of the display screen, followed by a blinking 
cursor. 


To use the Monitor, you type commands at the keyboard. When you 
have finished using the Monitor, you return to the BASIC language 
you were previously using by pressing Control-Reset, by pressing 
Control-C then Return, or by typing 3D0G @D-zero-G), which 
executes the resident program—usually Applesoft—whose address . 
is stored in a jump instruction at location $3D0. 
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See “Summary of Monitor 
Commands” at the end of this 
chapter. 


Syntax of Monitor commands 


To give a command to the Monitor, you type a line on the 
keyboard, then press Return. The Monitor accepts the line using the 
standard I/O subroutine GETLN, described in Chapter 3. A 
Monitor command can be up to 255 character in length, ending 
with a carriage return. 


A Monitor command can include three kinds of information: 
addresses, data values, and command characters. You type 
addresses and data values in hexadecimal notation. Hexadecimal 
notation uses the ten decimal digits (0-9) and the first six letters 
(A-F) to represent the sixteen values from 0 to 15. A pair of 
hexadecimal digits represent values from 0 to 255, corresponding 
to a byte; and a group of four hexadecimal digits can represent 
values from 0 to 65,536, corresponding to a word. Any address in 
the Apple Ile can be represented by four hexadecimal digits. 


When the command you type calls for an address, the Monitor 
accepts any group of hexadecimal digits. If there are fewer than four 
digits in the group, it adds leading zeros; if there are more than four 
hexadecimal digits, the Monitor uses only the last four digits. It 
follows a similar procedure when the command syntax calls for two- 
digit data values. j 


Each command you type consists of one command character, 
usually the first letter of the command name. When the command is 
a letter, it can be either uppercase or lowercase. The Monitor 
recognizes 23 different command characters. Some of them are 
punctuation marks, some are letters, and some are control 
characters. 


“ Noie: Although the Monitor recognizes and interprets control 
characters typed on an input line, they do not appear on the 
screen. 


This chapter contains many examples of the use of Monitor 
commands. In the examples, the commands and values you type 
are shown in a normal typeface and the responses of the Monitor 
are in a computer typeface. Of course, when you perform the 
examples, all of the characters that appear on the display screen 
will be in the same typeface. Some of the data values displayed by 
your Apple Ile may differ from the values printed in these 
examples, because they are variables stored in programmable 
memory. 
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Monitor memory commands 


When you use the Monitor to examine and change the contents of 
memory, it keeps track of the address of the last location whose 
value you inquired about and the address of the location that is next 
to have its value changed. These are called the ast opened location 
and the next changeable location. 


Examining memory contents 


When you type the address of a memory location and press Return, 
the Monitor responds with the address you typed, a dash, a space, 
and the value stored at that location, like this: 


*E000 

E000- 20 
*33 

0033- AA 


* 


Each time the Monitor displays the value stored at a location, it 
saves the address of that location as the last opened location and as 
the next changeable location. 


Memory dump 


When you type a period () followed by an address and then press 
Return, the Monitor displays a memory dump: the data values 
stored at all the memory locations from the one following the last 
opened location to the location whose address you typed following 
the period. The Monitor saves the last location displayed as both 
the last opened location and the next changeable location. The 
amount of data displayed by the Monitor depends on how much 
larger than the last opened location the address after the period is; 
here are some examples: 


*20 
0020- 00 
* 2B 


0021- 28 00 18 OF OC 00 00 
0028- A8 06 DO 07 
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*300 
0300- 99 
*.315 


0301- B9 00 08 OA OA OA 99 
0308- 00 08 C8 DO F4 AG 2B AY 
0310- 09 85 27 AD CC 03 


*.32A 


0316- 85 41 

0318- 84 40 8A 4A 4A 4A 4A 09 
0320- CO 85 3F A9 5D 85 3E 20 
0328- 43 03 20 


* 


When the Monitor performs a memory dump, it starts at the 
location immediately following the last opened location and 
displays that address and the data value stored there. It then 
displays the values of successive locations up to and including the 
location whose address you typed, but only up to eight values on a 
line. When it reaches a location whose address is a multiple of 
eight—that is, one that ends with an 8 or a 0—it displays that 
address as the beginning of a new line, then continues displaying 
more values. 


After the Monitor has displayed the value at the location whose 
address you specified in the command, it stops the memory dump 
and sets that location as both the last opened location and the next 
changeable location. If the address specified on the input line is less 
than the address of the last opened location, the Monitor displays 
only the address and value of the location following the last opened 
location. 


You can combine the two commands, opening a location and 
dumping memory, by simply concatenating them: type the first 
address, a period, and the second address. This combination of 
two addresses separated by a period is called a memory range. 


*300.32F 


0300- 99 B9 00 O08 OA OA OA 99 
0308- 00 08 C8 DO F4 A6 2B AY 
0310- 09 85 27 AD CC 03 85 41 
0318- 84 40 8A 4A 4A 4A 4A 09 
0320- CO 85 3F AQ 5D 85 3E 20 
0328- 43 03 20 46 03 AS 3D 4D 
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*30.40 


0030- AA 00 
0038- 1B FD 
0040- 30 
*E015.E025 
E016- 4C ED 
E018- A9 20 
E020- AO 07 


FF AA 05 C2 05 C2 
DO 03 3C 00 40 00 


FD 
C5 24 BO OC AY 8D 
20 ED FD AQ * 


Pressing Return by itself causes the Monitor to display one line of a 
memory dump; that is, a memory dump from the location 
following the last opened location to the next multiple-of-eight 
boundary. The Monitor saves the address of the last location 
displayed as the last opened location and the next changeable 


location. 

*5 

0005- 00 
*Return 

00 00 
*Return 
0008- 00 00 
*32 

0032- FF 
*Return 

AA 00 C2 05 


*Return 


00 00 00 00 00 00 


c2 


0038- 1B FD DO 03 3C 00 3F 00 


* 
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Warning 


Changing memory contents 


The preceding section showed you how to display the values stored 
in the Apple Ile’s memory; this section shows you how to change 
those values. You can change any location in RAM— 
programmable memory—and you can also change the soft switches 
and output devices by changing the locations assigned to them. 


Use these commands carefully. If you change the zero-page 
locations used by Applesoft, ProDOS, or DOS, you may lose 
programs or data stored in memory. 


Changing one byte 


The previous commands keep track of the next changeable 
location; these commands make use of it. In the next example, you 
open location 0, then type a colon (:) followed by a value: 


*0 
0000- 00 
*:5F 


The contents of the next changeable location have just been 
changed to the value you typed, as you can see by examining that 
location: 


*0 


Q000- SF 


* 


You can also combine opening and changing into one operation by 
typing an address followed by a colon and a value. In the example, 
you type the address again to verify the change: 


*302:42 
*302 
0302- 42 


* 


When you change the contents of a location, the value that was 
contained in that location disappears, never to be seen again. The 
new value will remain until you replace it with another value. 
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Changing consecutive locations 


You don’t have to type a separate command with an address, a 
colon, a value, and Return for each location you want to change. 
You can change the values of up to 85 consecutive locations at a 
time (or even more, if you omit leading zeros from the values) by 
typing only the initial address and colon followed by all the values 
separated by spaces, and ending with Return. The Monitor will duly 
store the consecutive values in consecutive locations, starting at the 
location whose address you typed. After it has processed the string 
of values, it takes the location following the last changed location as 
the next changeable location. Thus, you can continue changing 
consecutive locations without typing an address on the next input 
line by typing another colon and more values. In these examples, 
you first change some locations, then examine them to verify the 
changes: 


*300:69 01 20 ED FD 4C 0 3 
*300 

0300- 69 

*Return 

01 20 ED FD 4C 00 03 
*10:0 1 2 3 

*:4567 

*10.17 


0010- 00 01 02 03 04 05 06 07 


* 


ASCII input mode 


The enhanced Apple Ile has an ASCII input mode that lets you enter 
ASCII characters just as you can their hexadecimal ASCII 
equivalents by preceding the literal character with an apostrophe 
(. This means that 'A is the same as $C1 and 'B is the same as $C2 
to the Monitor. The ASCII value for any character following an 
apostrophe is used by the Monitor. 
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Important 


Original Ile 


Each character to be placed in memory should be delimited by a 
leading apostrophe (") and a trailing space. The only exception to 
this rule is that the last character in the line is followed with a return 
character instead of a space. The following example would enter the 
string “Hooray for sushi!” at $0300 in memory. 


*300:'H 'o 'o 'v 'g y 1 i 'o 'r ' 's 'y 's 'h Wo " 


ASCII input mode sets the high bit of the code for a character 
that you enter. So 'A will equal $C1, not $41. 


The original Apple lle does not have an ASCII input mode. 


Moving data in memory 


You can copy a block of data stored in a range of memory locations 
from one area in memory to another by using the Monitor’s MOVE 
command. To move a range of memory, you must tell the Monitor 
both where the data is now situated in memory (the source 
locations) and where you want the copy to go (the destination 
locations). You give this information to the Monitor by means of 
three addresses: the address of the first location in the destination 
and the addresses of the first and last locations in the source. You 
specify the starting and ending addresses of the source range by 
separating them with a period. You separate the destination address 
from the range addresses with a less-than character (<), which you 
may think of as an arrow pointing in the direction of the move. 
Finally, you tell the Monitor that this is a MOVE command by 
typing the letter 4 Gin either lowercase or uppercase). The format 
of the complete MOVE command looks like this: 


{destination} < {star} . {end} M 


When you type the actual command, the words in braces should be 
replaced by hexadecimal addresses, and the braces and spaces 
should be omitted. 


Here are some examples of Monitor commands, including some 
memory moves. First, you examine the values stored in one range 
of memory, then store several values in another range of memory; 
the actual MOVE commands end with the letter M. 
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See the section “Special Tricks 
With the Monitor” later in this 


* 0.F 


0000- 5F 00 05 07 00 00 00 00 
0008- 00 00 00 00 00 00 00 00 


*300:A9 8D 20 ED FD A9 45 20 DA FD 4C 00 03 
*300.30C 


0300- A9 8D 20 ED FD A9 45 20 
0308- DA FD 4C 00 03 


*0<300.30CM 
*0.C 


0000- A9 8D 20 ED FD AQ 45 20 
0008- DA FD 4C 00 03 


*310<8.AM 
*310.312 

0310- DA FD 4c 
*2<7.9M 

*0.C 


0000- A9 8D 20 DA FD AQ 45 20 
0008- DA FD 4C 00 03 


* 


The Monitor moves a copy of the data stored in the source range of 
locations to the destination locations. The values in the source 
range are left undisturbed. The Monitor remembers the last 
location in the source range as the last opened location, and the 
first location in the source range as the next changeable location. If 
the second address in the source range specification is less than the 
first, then only one value (that of the first location in the range) will 
be moved. 


If the destination address of the MOVE command is inside the 
source range of addresses, then strange (and sometimes wonderful) 
things happen: the locations between the beginning of the source 


chapter for an interesting range and the destination address are treated as a subrange and the 
application of this feature. values in this subrange are replicated throughout the source range. 
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See the section “Special Tricks 
With the Monitor” later in this 
chapter. 


Comparing data in memory 


You can use the VERIFY command to compare two ranges of 
memory using the same format you use to move a range of memory 
from one place to another. In fact, the VERIFY command can be 
used immediately after a MOVE command to make sure that the 
move was successful. 


The VERIFY command, like the MOVE command, needs a range 
and a destination. The syntax of the VERIFY command is 


{destination} < {star} . {end V 


The Monitor compares the values in the source locations with the 
values in the locations beginning at the destination address. If any 
values don’t match, the Monitor displays the address at which the 
discrepancy was found and the two values that differ. In the 
example, you store data values in the range of locations from 0 

to $D, copy them to locations starting at $300 with the MOVE 
command, and then compare them using the VERIFY command. 
When you use the VERIFY command after you change the value at 
location 6 to $E4, it detects the change. 


*0:D7 F2 E9 F4 F4 ES EE AO E2 F9 AO C3 C4 C5 
*300<0.DM 

*300<0.DV 

*6:E4 

*300<0.DV 


O006-E4 (EE) 
* 


If the VERIFY command finds a discrepancy, it displays the address 
of the location in the source range whose value differs from its 
counterpart in the destination range. If there is no discrepancy, 
VERIFY displays nothing. The VERIFY command leaves the values 
in both ranges unchanged. The last opened location is the last 
location in the source range, and the next changeable location is 
the first location in the source range, just as in the MOVE 
command. If the ending address of the range is less than the starting 
address, the values of only the first locations in the ranges will be 
compared. Like the MOVE command, the VERIFY command also 
does unusual things if the destination address is within the source 
range. 
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Original Ile 


Searching for bytes in memory 


The SEARCH command lets you search for one or two bytes (either 
hexadecimal values or ASCII characters) in a range of memory. You 
must type in the ASCII string (or hexadecimal number or numbers) 
in reverse of the order that they appear in memory. Think of the 
SEARCH command as looking for items in a last-in, first-out queue. 


The syntax of the SEARCH command is 


{value or ASCI)}<{start}.{end} S 


If the byte (or two-byte sequence) that you specify is in the specified 
memory range, the Monitor will return with a list of the addresses 
where that byte (or byte sequence) occurs. If the byte (or byte 
sequence) is not in the range, the Monitor just displays the prompt 


The following example looks for the character string “LO” in 
memory between $0300 and $03FF: 


*'O’L<300.3FFS 


“ High bit set: Remember that ASCII input mode sets the high- 
order bit of each character that you enter. 


The next example searches for the two-byte sequence $FF11. 
*11FF<300.3FFS 


You can’t search for a two-byte sequence with a high byte of 0. The 
Monitor ignores the high byte and searches for the low byte only. 
The sequence OOFF is seen by the Monitor SEARCH command as FF. 


The Monitor in the original Apple lle does not recognize the 
SEARCH command. 


Examining and changing registers 


The microprocessor’s register contents change continuously 
whenever the Apple Ile is running any sort of program, such as the 
Monitor. The Monitor lets you see what the register contents were 
when you invoked the Monitor or a program that you were 
debugging stopped at a break (BRK). The Monitor also lets you set . 
65C02 register values before you execute a program with the GO 
command. 
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When you call the Monitor, it stores the contents of the 
microprocessor’s registers in memory. The registers are stored in 
the order A, X, Y, P (processor status register), and S (stack 
pointer), starting at location $45 (decimal 69). When you give the 
Monitor a GO command, the Monitor loads the registers from 
these five locations before it executes the first instruction in your 
program. 


Pressing Control-E and then Return invokes the Monitor's 
EXAMINE command, which displays the stored register values and 
sets the location containing the contents of the A register as the next 
changeable location. After using the EXAMINE command, you can 
change the values in these locations by typing a colon and then 
typing the new values separated by spaces. In the following 
example, you display the registers, change the first two, and then 
display them again to verify the change. 


*Control-E 

A=0A X=FF Y=D8 P=BO S=F8 
*:BO 02 

*Control-E 


A=BO X=02 Y=D8 P=BO S=F8 


* 


Monitor cassette tape commands 


The Apple Ile has two jacks for connecting an audio cassette tape 
recorder. With a recorder connected, you can use the Monitor 
commands described later in this section to save the contents of a 
range of memory onto a standard cassette and recall it for later use. 


Saving data on tape 


The Monitor’s WRITE command saves the contents of up to 65,536 
memory locations on cassette tape. To save a range of memory on 
tape, give the Monitor the starting and ending addresses of the 
range, followed by the letter W (for WRITB), like this: 


{star} . {end W 
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Don’t press Return yet: first, put the tape recorder in record mode 
and let the tape run for a second, then press Return. The Monitor 
will write a ten-second tone onto the tape and then write the data. 
The tone acts as a leader: later, when the Monitor reads the tape, 
the leader enables the Monitor to get in step with the signal from the 
tape. When the Monitor is finished writing the range you specified, 
it will sound a bell (beep) and display a prompt. You should rewind 
the tape and label it with the memory range that’s on the tape and 
what it’s supposed to be. 


Here’s a small example you can save and use later to try out the 
READ command. Remember that you must start the cassette 
recorder in record mode before you press Return after typing the 
WRITE command. 


*0.FF FF AD 30 CO 88 DO 04 C6 01 FO 08 CA 
DO F6 A6 00 4C 02 00 60 
*0.14 


0000- FF FF AD 30 CO 88 DO 04 
0008- C6 01 FO 08 CA DO F6 A6 
0010- 00 4C 02 00 60 


*0.14W 


* 


It takes about 35 seconds total to save the values of 409%6 memory 
locations preceded by the ten-second leader onto tape. This works 
out to an average data transfer rate of about 1350 bits per second. 


The WRITE command writes one extra value on the tape after it has 
written the values in the memory range. This extra value is the 
checksum, which is the eight-bit partial sum of all values in the 
range. When the Monitor reads the tape, it uses this value to 
determine if the data has been written and read correctly. (See the 
next section.) 
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Reading data from tape 


Once you’ve saved a memory range onto tape with the Monitor's 
WRITE command, you can read that memory range back into the 
computer by using the Monitor’s READ command. The data values 
you’ve stored on the tape need not be read back into the same 
memory range from whence they came; you can tell the Monitor to 
put those values into any memory range in the computer’s memory, 
provided that it’s the same size as the range you saved. 


The format of the READ command is the same as that of the WRITE 
command, except that the command letter is R: 


{start} . {end} R 


Once again, after typing the command, don’t press Return. 
Instead, start the tape recorder in play mode and wait a few 
seconds. Although the WRITE command puts a ten-second leader 
tone on the beginning of the tape, the READ command needs only 
three seconds of this leader to lock on to the signal from the tape. 
You should let a few seconds of tape go by before you press Return 
to allow the tape recorder’s output to settle down to a steady tone. 


This example has two parts. First, you set a range of memory to 
zero, verify the contents of memory, and then type the READ 
command (but don’t press Return). 


*O7000000000000000000000 
*0.14 


0000- 00 00 00 00 00 00 00 00 
0008- 00 00 00 00 00 00 00 00 
0010- 00 00 00 00 00 


0.14R 


Now start the cassette running in play mode, wait a few seconds, and 
press Return. After the Monitor sounds the bell (beep) and displays 
the prompt, examine the range of memory to see that the values 
from the tape were read correctly. 


*0.14 


0000- FF FF AD 30 CO 88 DO 04 
0008- C6 01 FO 08 CA DO F6 A6 
0010- 00 4C 02 00 60 


* 
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After the Monitor has read all the data values on the tape, it reads 
the checksum value. It computes the checksum on the data it read 
and compares it to the checksum from the tape. If the two 
checksums differ, the Monitor sends a beep to the speaker and 
displays ERR. This warns you that there was a problem reading the 
tape and that the values stored in memory aren’t the values that were 
recorded on the tape. If the two checksums match, the Monitor will 
just send out a beep and display a prompt. 


Miscellaneous Monitor commands 


These Monitor commands enable you to change the video display 
format from normal to inverse and back, and to assign input and 
output to accessories in expansion slots. 


Inverse and normal display 


You can control the setting of the inverse-normal mask location 
used by the COUT subroutine (described in Chapter 3) from the 
Monitor so that all of the Monitor’s output will be in inverse format. 
The INVERSE command, I, sets the mask such that all subsequent 
inputs and outputs are displayed in inverse format. To switch the 
Monitor’s output back to normal format, use the NORMAL 
command, N. 


*0.F 


0000- OA OB OC OD OE OF DO 04 
0008- C6 01 FO 08 CA DO F6 A6 


*] 
*0.F 


0000- OA OB OC OD OE OF DO 04 
0008- C6 01 FO 08 CA DO F6 Aé6 


*N 
*0.F 


0000- OA OB OC OD OE OF DO 04 
0008- Cé 01 FO 08 CA DO F6 A6 


Chapter 5: Using the Monitor 


Warning 


Back to BASIC 


Use the BASIC command, Control-B, to leave the Monitor and 
enter the BASIC that was active when you entered the Monitor. 
Normally, this is Applesoft BASIC, unless you deliberately switched 
to Integer BASIC. Any program or variables that you had previously 
in BASIC will be lost. If you want to reenter BASIC with your 
previous program and variables intact, use the CONTINUE BASIC 
command, Control-C. 


If you are using DOS 3.3 or ProDOS, press Control-Reset or type 
3D0G to return to the language you were using, with your program 
and variables intact. 


“ That's a number, not a letter: If you use 3DOG, make sure that 
the third character you type is a zero, not a letter O. The letter G 
is the Monitor’s GO command, described in the section 
“Machine-Language Programs” later in this chapter. 


Redirecting input and output 


The PRINTER command, activated by Control-P, diverts all output 
normally destined for the screen to an interface card in a specified 
expansion slot, from 1 to 7. There must be an interface card in the 
specified slot, or you will lose control of the computer and your 

program and variables may be lost. The format of the command is 


{slot number} Control-P 


A PRINTER command to slot number 0 will switch the stream of 
output characters back to the Apple IIe’s video display. 


Don‘t give the PRINTER command with slot number 0 to 
deactivate the 80-column firmware, even though you used this 
command to activate it in slot 3. The command works, but it 
Just disconnects the firmware, leaving some of the soft switches 
set for 80-column display. 


In much the same way that the PRINTER command switches the 
output stream, the KEYBOARD command substitutes the interface 
card in a specified expansion slot for the Apple Ile’s normal input 
device, the keyboard. The format for the KEYBOARD command is 


{slot number Control-K 


A slot number of 0 for the KEYBOARD command directs the 
Monitor to accept input from the Apple Ile’s built-in keyboard. 


The PRINTER and KEYBOARD commands are the exact equivalents 
of the BASIC commands PR# and IN#. 
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Hexadecimal arithmetic 


The Monitor will also perform one-byte hexadecimal addition and 
subtraction. Just type a line in one of these formats: 


{value + {value} {value} — {value} 


The Apple IIe performs the arithmetic and displays the result, as 
shown in these examples: 


*20+13 
=33 
*4A-C 


Special tricks with the Monitor 


This section describes some more complex ways of using the 
Monitor commands. 


Multiple commands 


You can put as many Monitor commands on a single line as you 
like, as long as you separate them with spaces and the total number 
of characters in the line is less than 254. Adjacent single-letter 
commands such as L, S, I, and N need not be separated by spaces. 


You can freely intermix all the commands except the STORE (:) 
command. Since the Monitor takes all values following a colon and 
places them in consecutive memory locations, the last value in a 
STORE must be followed by a letter command before another 
address is encountered. You can use the NORMAL command as the 
required letter command in such cases; it usually has no effect and 
can be used anywhere. 
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In the following example, you display a range of memory, change 
it, and display it again, all with one line of commands: 


*300.307 300:18 69 1 N 300.302 


0300- 00 00 00 00 00 00 00 00 
0300- 18 69 01 


* 


If the Monitor encounters a character in the input line that it does 
not recognize as either a hexadecimal digit or a valid command 
character, it executes all the commands on the input line up to that 
character, then grinds to a halt with a noisy beep and ignores the 
remainder of the input line. 


Filling memory 


The MOVE command can be used to replicate a pattern of values 
throughout a range of memory. To do this, first store the pattern in 
the first locations in the range. 


*300:11 22 33 


Remember the number of values in the pattern: in this case, it is 
three. Use the number to compute addresses for the MOVE 
command, like this: 


{start+numben < {star} . {end-number M 


This MOVE command will first replicate the pattern at the locations 
immediately following the original pattern, then replicate that 
pattern following itself, and so on until it fills the entire range. 


*303<300.32DM 
*300.32F 


0300- 11 22 33 11 22 33 11 22 
0308- 33 11 22 33 11 22 33 11 
O0310— 22 323: 11 22 33 11 22 33 
0318- 11 22 33 11 22 33 11 22 
O320= 33 11,22 33 Fl 22 33 11 


0328- 22 33 11 22 33 11 22 33 
* 
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You can do a similar trick with the VERIFY command to check 
whether a pattern repeats itself through memory. This is especially 
useful to verify that a given range of memory locations all contain 
the same value. In this example, you first fill the memory range 
from $0300 to $0320 with zeros and verify it, then change one 
location and verify again, to see the VERIFY command detect the 
discrepancy: 


*300:0 

*301<300.31FM 
*301<300.31FV 

*304:02 

*301<300.31FV 

0303-00 (02) 0304-02 (00) 


* 


Repeating commands 


You can create a command line that repeats one or more 
commands over and over. You do this by beginning the part of the 
command line that you want to repeat with a letter command, such 
as N, and ending it with the sequence 34:n, where n is a 
hexadecimal number that specifies the position in the line of the 
command where you want to start repeating; for the first character 
in the line, n=0. The value for n must be followed with a space in 
order for the loop to work properly. 


This trick takes advantage of the fact that the Monitor uses an index 
register to step through the input buffer, starting at location $0200. 
Each time the Monitor executes a command, it stores the value of 
the index at location $34, when that command is finished, the 
Monitor reloads the index register with the value at location $34. By 
making the last command change the value at location $34, you 
change this index so that the Monitor picks up the next command 
character from an earlier point in the buffer. 
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The only way to stop a loop like this is to press Control-Reset, that is 


how this example ends. 


*N 300 302 34:0 


0300- 
0302- 
0300- 
0302- 
0300- 
0302- 
0300- 
0302- 
0300- 
0302- 
0300- 
0302- 
030 


* 


A 
33: 
11 
33 
11 
33 
11 
33) 
44 
33) 
bad 
33 


Creating your own commands 


The USER command, Control-Y, forces the Monitor to jump to 


memory location $03F8. You can put a JMP instruction there that 
jumps to your own machine-language program. Your program can 


then examine the Monitor’s registers and pointers or the input 


buffer itself to obtain its data. For example, here is a program that 


displays everything on the input line after the Control-Y. The 


program starts at location $0300; the command line that starts with 
$03F8 stores a jump to $0300 at location $03F8. 


*300:A4 34 B9 00 02 20 ED FD C8 C9 8D DO F5 4C 69 FF 


*378:4C 00 03 


*Control-Y THIS IS A TEST 


THIS IS A TEST 


* 
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Machine-language programs 


The main reason to program in machine language is to get more 
speed. A program in machine language can run much faster than 
the same program written in high-level languages such as BASIC or 
Pascal, but the machine-language version usually takes a lot longer 
to write. There are other reasons to use machine language: you 
might want your program to do something that isn’t included in 
your high-level language, or you might just enjoy the challenge of 
using machine language to work directly on the bits and bytes. 


« Boning up on machine language: If you have never used 
machine language before, you'll need to learn the 65C02 
instructions listed in Appendix A. To become proficient at 
programming in machine language, you'll have to spend some 
time at it and study at least one of the books on 6502 
programming listed in the bibliography. With the books and 
Appendix A, you'll have the needed information to program 
the 65C02. 


You can get a hexadecimal dump of your program, move it around 
in memory, or save it on tape and recall it using the commands 
described in the previous sections. The Monitor commands in this 
section are intended specifically for you to use in creating, writing, 
and debugging machine-language programs. 


Running a program 


The Monitor command you use to start execution of your machine- 
language program is the GO command. When you type an address 
and the letter G, the Apple Ile starts executing machine language 
instructions starting at the specified location. If you just type G, 
execution starts at the last opened location. The Monitor treats this 
program as a subroutine: it should end with an RTS (return from 
subroutine) instruction to transfer control back to the Monitor. 
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The word mnemonic comes from 
the same root as memory and 
refers to short acronyms that 
are easier to remember than the 
hexadecimal operation codes 
themselves: for example. for 
clear carry you write CLC 
instead of $18. 


The Monitor has some special features that make it easier for you to 
write and debug machine-language programs, but before you get 
into that, here is a small machine-language program that you can 
run using only the simple Monitor commands already described. 
The program in the example merely displays the letters A 

through Z: you store it starting at location $0300, examine it to be 
sure you typed it correctly, then type 300G to start it running. 


*300:A9 C1 20 ED FD 18 69 1 C9 DB DO F6 60 
*300.30C 


0300- A9 Cl 20 ED FD 18 69 01 
0308- C9 DB DO Fé 60 


*300G ABCDEFGHIJKLMNOPORSTUVWXYZ 


* 


Disassembled programs 


Machine-language code in hexadecimal isn’t the easiest thing in the 
world to read and understand. To make this job a little easier, 
machine-language programs are usually written in assembly 
language and converted into machine-language code by programs 
called assemblers. 


Since programs that translate assembly language into machine 
language are called assemblers, a program like the Monitor’s LIST 
command that translates machine language into assembly language 
is called a disassembler. 


The Monitor’s LIST command displays machine-language code in 
assembly-language form. Instead of unformatted hexadecimal 
gibberish, the LIST command displays each instruction on a 
separate line, with a three-letter instruction name, or mnemonic, 
and a formatted hexadecimal operand. The LIST command also 
converts the relative addresses used in branch instructions to 
absolute addresses. 
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The Monitor LIST command has the format 
{location} L 


The LIST command starts at the specified location and displays as 
much memory as it takes to make up a screenful (20 lines) of 
instructions, as shown in the following example: 


*300L 

0300- A9 Cl LDA #$Cl1 
0302- 20 ED FD JSR $FDED 
0306- 18 CLC 

0306- 69 01 ADC #$01 
0308- CQ DB CMP #$DB 
030A- DO F6 BNE $0302 
030C- 60 RTS 

030D- 00 BRK 

030E- 00 BRK 

030F- 00 BRK 

0310- 00 BRK 

0311- 00 BRK 

0312- 00 BRK 

0313- 00 BRK 

0314- 00 BRK 

0316- 00 BRK 

0316- 00 BRK 

0317- 00 BRK 

0318- 00 BRK 

0319- 00 BRK 


* 


The first seven lines of this example are the assembly-language form 
of the program you typed in the previous example. The rest of the 
lines are BRK instructions only if this part of memory has zeros in it: 
other values will be disassembled as other instructions. 


The Monitor saves the address that you specify in the LIST 
command, but not as the last opened location used by the other 
commands. Instead, the Monitor saves this address as the program 
counter, which it uses only to point to locations within programs. 
Whenever the Monitor performs a LIST command, it sets the 
program counter to point to the location immediately following the 
last location displayed on the screen, so that if you type another 
LIST command it will display another screenful of instructions, 
starting where the previous display left off. 
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The Mini-Assembler 


Without an assembler, you have to write your machine-language 
program, take the hexadecimal values for the opcodes and 
operands, and store them in memory using the commands covered 
in the previous sections. That is exactly what you did when you ran 
the previous examples. 


The Monitor includes an assembler called the Mini-Assembler that 
lets you enter machine-language programs directly from the 
keyboard of your Apple. ASCII characters can be entered in Mini- 
Assembler programs, exactly as you enter them in the Monitor. 
Note that the Mini-Assembler doesn’t accept labels; you must use 
actual values and addresses. 


Starting the Mini-Assembler 


To start the Mini-Assembler first invoke the Monitor by typing 
CALL -151 and pressing Return, and then from the Monitor, type 
! followed by Return. The Monitor prompt character then changes 
from * to !. 


When you finish using the Mini-Assembler, press Return from a 
blank line to return to the Monitor. 


Restrictions 


The Mini-Assembler supports only the subset of 65C02 instructions 
that are found on the 6502. 


Before you can use the Mini-Assembler on the original Apple lle, 


you have to be running Integer BASIC. When you start up the 
computer using DOS or either BASIC, the Apple lle loads the 
Integer BASIC interpreter from the file named INTBASIC into the 
bank-switched RAM. Here’s how to start the Mini-Assembler on 
an original Apple lle: 


1. Start Integer BASIC from DOS 3.3 by typing INT and pressing 
Return. 


2. After the Integer prompt character (>) and a cursor appear, 
enter the Monitor by typing CALL -151 and pressing Return. 


3. Now start the Mini-Assembler by typing F666G and pressing 
Return. 
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The Mini-Assembler saves one address, that of the program 
counter. Before you start to type a program, you must set the 
program counter to point to the location where you want the Mini- 
Assembler to store your program. Do this by typing the address 
followed by a colon. 


After the colon, type the mnemonic for the first instruction in your 
program, followed by a space and the operand of the instruction. 
Now press Return. The Mini-Assembler converts the line you typed 
into hexadecimal, stores it in memory beginning at the location of 
the program counter, and then disassembles it again and displays 
the disassembled line. It then displays a prompt on the next line. 


Now the Mini-Assembler is ready to accept the second instruction 
in your program. To tell it that you want the next instruction to 
follow the first, don’t type an address or a colon: just type a space 
and the next instruction’s mnemonic and operand, then press 


Formats for operands are listed Return. The Mini-Assembler assembles that line and waits for 
in Table 5-1. another. 
1300:LDX #02 
0300- A2 02 LDX #$02 
! LDA $0,X 
0302- BS 00 LDA $00,X 
! STA $10,X 
0304 95 10 STA $10,X 
! DEX 
0306- CA DEX 
! STA $C030 


0307- 8D 30 CO STA $C030 


! BPL $302 

O30A- 10 F6 BPL $0302 
! BRK 

030C- 00 BRK 


! 
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If the line you type has an error in it, the Mini-Assembler beeps 
loudly and displays a caret (~) under or near the offending 


character in the input line. Most common errors are the result of 
typographical mistakes: misspelled mnemonics, missing 


parentheses, and so forth. The Mini-Assembler also rejects the 
input line if you forget the space before or after a mnemonic or 


include an extraneous character in a hexadecimal value or address. 
If the destination address of a branch instruction is out of the range 
of the branch (more than 127 locations distant from the address of 


the instruction), the Mini-Assembler flags this as an error. 


There are several different ways to leave the Mini-Assembler and 
reenter the Monitor. On an enhanced Apple Ile only, simply press 


Return at a blank line. 


On any Apple Ile, you can press Control-Reset, which forces a 


warm restart of BASIC, then type CALL -151. 


On an original Apple lle, type the Monitor command SFF69G. 


Your assembly-language program is now stored in memory. You 
can display it with the LIST command: 


*3001 

0300- A2 
0302- BS 
0304- 95 
0306- CA 
0307- 8D 
O30A- 10 
030C- 00 
030D- 00 
030E- 00 
O30F- 00 
0310- 00 
0311- 00 
0312- 00 
0313- 00 
0314- 00 
0316- 00 
0316- 00 
0317- 00 
0318- 00 
0319- 00 


* 


02 
00 
10 


30 CO 
F6 


LDX 
LDA 
STA 
DEX 
STA 
BPL 
BRK 
BRK 
BRK 
BRK 
BRK 
BRK 
BRK 
BRK 
BRK 
BRK 
BRK 
BRK 
BRK 
BRK 


#502 
$00,X 
$10,X 


$C030 
$0302 
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See Appendix A for more 
Information about 65C02 (and 
6502) instructions. 


Table 5-1 
Mini-Assembler address formats 





Addressing mode _ Format 


Accumulator ¥ 

Implied . 
Immediate #${value} 
Absolute ${address} 
Zero page ${address} 


Indexed zero ${address},X 


page ${address},Y 
Indexed ${address},X 
absolute ${address},Y 
Relative ${address} 
Indexed (${address},X) 
indirect 

Indirect (${address}),Y 
indexed 

Absolute (${address}) 
indirect 


* These instructions have no 
operands. 


126 


Mini-Assembler instruction formats 


The Apple Mini-Assembler recognizes 56 mnemonics and 13 
addressing formats. These constitute the 6502 subset of the 65C02 
instruction set. The mnemonics are standard, as used in the 
Synertek Programming Manual (Apple part number A2L0003), 
but the addressing formats are somewhat different. Table 5-1 shows 
the Apple standard address-mode formats for 6502 assembly 
language. 


An address consists of one or more hexadecimal digits. The Mini- 
Assembler interprets addresses the same way the Monitor does: if 
an address has fewer than four digits, the Mini-Assembler adds 
leading zeros; if the address has more than four digits, then it uses 
only the last four. 


* Dollar signs: In this manual, dollar signs ($) in addresses signify 
that the addresses are in hexadecimal notation. They are 
ignored by the Mini-Assembler and may be omitted when 
typing programs. 


There is no syntactical distinction between the absolute and zero- 
page addressing modes. If you give an instruction to the Mini- 
Assembler that can be used in both absolute and zero-page mode, 
the Mini-Assembler assembles that instruction in absolute mode if 
the operand for that instruction is greater than $FF, and it 
assembles it in zero-page mode if the operand is less than $0100. 


Instructions in accumulator mode and implied addressing mode 
need no operands. 


Branch instructions, which use the relative addressing mode, 
require the target address of the branch. The Mini-Assembler 
calculates the relative distance to use in the instruction 
automatically. If the target address is more than 127 locations 
distant from the instruction, the Mini-Assembler sounds a bell 
(beep), displays a caret (~) under the target address, and does not 
assemble the line. 


If you give the Mini-Assembler the mnemonic for an instruction 
and an operand, and the addressing mode of the operand cannot 
be used with the instruction you entered, the Mini-Assembler will 
not accept the line. 
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Summary of Monitor commands 


Here is a summary of the Monitor commands, showing the syntax 
for each one. 


Examining memory 


{adrs} Examines the value contained in one 
location. 
{adrs I} {adrs2} Displays the values contained in all 


locations between {adrs2} and {adrsQ. 


Return Displays the values in up to eight locations 
following the last opened location. 


Changing the contents of memory 


{adrs}:{vah {va} Stores the values in consecutive memory 
locations starting at {adrs}. 


{val{vab... Stores values in memory starting at the next 
changeable location. 


Moving and comparing 


{dest}<{start}.{end}M Copies the values in the range 
{star}.{end into the range beginning at 
{desi}. 


{desi}<{start}.{end}V Compares the values in the range 
{star}.{end} to those in the range 
beginning at {des#. 


The Examine command 


Control-E Displays the locations where the contents 
of the 65C02’s registers are stored and 
opens them for changing. 
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The Search command 


{vah<{stari. {ends 


Displays the address of the first 
occurrence of {va in the specified range 
beginning at {star#. 


Cassette tape commands 


{start} {end} W 


{start}. {endR 


Writes the values in the memory range 
{starh. {end onto tape, preceded by a 
ten-second leader. 


Reads values from tape, storing them 

in memory beginning at {star} and 
stopping at {end. Prints ERR if an error 
occurs. 


Miscellaneous Monitor commands 


I 
N 
Control-B 


Control-C 


{vah+{vah 


{va}-{va}} 


{slot} Control-P 


Control-Y 


128 Chapter 5: Using the Monitor 


Sets inverse display mode. 
Sets normal display mode. 


Enters the language currently active 
(usually Applesoft). 


Returns to the language currently active 
(usually Applesoft). 


Adds the two values and prints the 
hexadecimal result. 


Subtracts the second value from the first 
and prints the result. 


Diverts output to the device whose 
interface card is in slot number {s/od. If 
{slo}=0, accepts input from the 
keyboard. 


Jumps to the machine-language 
subroutine at location $3F8. 


Original lle 


Running and listing programs 


{adrs}G 


{adrs}L 


Transfers control to the machine language 
program beginning at {adrs}. 


Disassembles and displays 20 
instructions, starting at {adrs}. 
Subsequent LIST commands display 20 
more instructions. 


The Mini-Assembler 


The Mini-Assembler is available on an original Apple lle only 
when Integer BASIC is active. See the earlier section “The Mini- 


Assembler.” 


F666G 


${command} 


$FF69g 


Return 


Invokes the Mini-Assembler on the 
original Apple Ile. 


Invokes the Mini-Assembler on the 
enhanced Apple Ile. 


Executes a Monitor command from the 
Mini-Assembler on the original 
Apple Ile. 


Leaves the Mini-Assembler on the 
original Apple He. 


Leaves the Mini-Assembler on the 
enhanced Apple Ile. 
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The seven expansion slots on the Apple Ile’s main circuit board are 
used for installing circuit cards containing the hardware and 
firmware needed to interface peripheral devices to the Apple Ie. 
These slots are not simple I/O ports; peripheral cards can access 
the Apple Ile’s data, address, and control lines via these slots. The 
expansion slots are numbered from 1 to 7, and certain signals, 
described below, are used to select a specific slot. 


Apple Il and II Plus The Apple Il and Apple Il Plus have an eighth expansion slot: 
slot number 0. On those models, slot 0 is normally used for a 
language card or a ROM card; the functions of the Apple Il 
Language Card are built into.the main circuit board of the 
Apple lle. 


Interrupt support on the enhanced Apple Ile requires that special 
attention be paid to cards designed to be in slot 3. A description of 
what you need to watch for is given at the end of this chapter. 


Original lle The interrupt support built into the enhanced (and extended 
keyboard) Apple lle is an enhanced and expanded version of 
the interrupt support in the original Apple lle. 


Peripheral-card memory spaces 


Because the Apple IJe’s microprocessor does all of its I/O through 
memory locations, portions of the Apple Ie’s memory space have 
been allocated for the exclusive use of the cards in the expansion 
slots. In addition to the memory locations used for actual I/O, there 
are memory spaces available for programmable memory (RAM) in 
the main memory and for read-only memory (ROM or PROM) on 
the peripheral cards themselves. 


The memory spaces allocated for the peripheral cards are 
described below. Those memory spaces are used for small 
dedicated programs such as I/O drivers. Peripheral cards that 
contain their own driver routines in firmware like this are called 
intelligent peripherals. They make it possible for you to add 
peripheral hardware to your Apple Ile without having to change 
your programs, provided that your programs follow normal 
practice for data input and output. 
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Table 6-1 
Peripheral-card |/O 
memory locations 
enabled by DEVICE 
SELECT’ 


Slot Locations 


$C090-$CO9F 
$COA0-$COAF 
$COBO-$COBF 
$COCO-$COCF 
$COD0-$CODF 
$COEO-$COEF 
$COFO-$COFF 


NNW KRWD 


Signals for which the active 
state Is low are marked with a 
prime (). 


Table 6-2 
Peripheral-card ROM 
memory locations 
enabled by I/O SELECT’ 


Slot Locations 


$C100-$C1FF 
$C200-$C2FF 
$C300-$C3FF 
$C400-$C4FF 
$C500-$CSFF 
$C600-$C6FF 
$C700-$C7FF 


NNAURWND 


See the section “I/O 
Programming Suggestions” later 
in this chapter. 


Peripheral-card I/O space 


Each expansion slot has the exclusive use of 16 memory locations 
for data input and output in the memory space beginning at 
location $C090. Slot 1 uses locations $C090 through $CO9F, slot 2 
uses locations $COAO through $COAF, and so on through location 
$COFF, as shown in Table 6-1. 


These memory locations are used for different I/O functions, 
depending on the design of each peripheral card. Whenever the 
Apple Ile addresses one of the 16 I/O locations allocated to a 
particular slot, the signal on pin 41 of that slot, named DEVICE 
SELECT’, switches to the active (low) state. This signal can be used 
to enable logic on the peripheral card that uses the 4 low-order 
address lines to determine which of its 16 I/O locations is being 
accessed. 





Peripheral-card ROM space 


One 256-byte page of memory space is allocated to each accessory 
card. This space is normally used for read-only memory (ROM or 
PROM) on the card with driver programs that control the operation 
of the peripheral device connected to the card. 


The page of memory allocated to each expansion slot begins at 
location $Cn00, where n is the slot number, as shown in Table 6-2 
and Figure 6-3. Whenever the Apple Ile addresses one of the 256 
ROM memory locations allocated to a particular slot, the signal on 
pin 1 of that slot, named I/O SELECT’, switches to the active dow) 
state. This signal enables the ROM or PROM devices on the card, 
and the eight low-order address lines determine which of the 256 
memory locations is being accessed. 





Expansion ROM space 


In addition to the small areas of ROM memory allocated to each 
expansion slot, peripheral cards can use the 2K-byte memory space 
from $C800 to $CFFF for larger programs in ROM or PROM. This 
memory space is called expansion ROM space. (See the memory 
map in Figure 6-3.) Besides being larger, the expansion ROM 
memory space is always at the same locations regardless of which 
slot is occupied by the card, making programs that occupy this 
memory space easier to write. 
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This memory space is available to any peripheral card that needs it. 
More than one peripheral card can have expansion ROM on it, but 
only one of them can be active at a time. 


Each peripheral card that uses expansion ROM must have a circuit 
on it to enable the ROM. The circuit does this by a two-stage 
process: first, it sets a flip-flop when the I/O SELECT’ signal, pin 1 
on the slot, becomes active Cow); second, it enables the expansion 
ROM devices when the I/O STROBE’ signal, pin 20 on the slot, 
becomes active (low). Figure 6-1 shows a typical ROM-enable 
circuit. 


The I/O SELECT’ signal on a particular slot becomes active 
whenever the Apple Ile’s microprocessor addresses a location in 
the 256-byte ROM address space allocated to that slot. The I/O 
STROBE’ signal on all of the expansion slots becomes active dow) 
when the microprocessor addresses a location in the expansion- 
ROM memory space, $C800-$CFFF. The I/O STROBE’ signal is 
used to enable the expansion-ROM devices on a peripheral card. 
(See Figure 6-1.) 


Important _ If there is an 80-column text card Installed In the auxiliary slot, 
some of the functions normally associated with slot 3 are 
performed by the 80-column text card and the built-in 80- 
column firmware. With the 80-column text card installed, the 
1/0 STROBE’ signal is not available on slot 3, so firmware in 
expansion ROM on a card In slot 3 will not run. 









1/0 SELECT’ 


$CFFF’ 


1/0 STROBE’ 


Figure 6-1 
Expansion ROM enable circuit 


ENABLE 1 









AO to Al0 
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Important 


A program on a peripheral card can get exclusive use of the 
expansion ROM memory space by referring to location $CFFF in its 
initialization phase. This location is special: all peripheral cards 
that use expansion ROM must recognize a reference to $CFFF as a 
signal to reset their ROM-enable flip-flops and disable their 
expansion ROMs. Of course, doing so also disables the expansion 
ROM on the card that is about to use it, but the next instruction in 
the initialization code sets the flip-flop in the expansion-ROM 
enable circuit on the card. 


A card that needs to use the expansion ROM space must first insert 
its slot address ($Cn) in $07F8 before it refers to $CFFF. This allows 
interrupting devices to reenable the card’s expansion ROM after 
interrupt handling is finished. Once its slot address has been 
inserted in $07F8, the peripheral card has exclusive use of the 
expansion memory space and its program can jump directly into 
the expansion ROM. 


As described earlier, the expansion-ROM disable circuit resets the 
enable flip-flop whenever the 65C02 addresses location $CFFF. To 
do this, the peripheral card must detect the presence of $CFFF on 
the address bus. You can use the I/O STROBE’ signal for part of the 
address decoding, since it is active for addresses from $C800 
through $CFFF. If you can afford to sacrifice some ROM space, you 
can simplify the address decoding even further and save circuitry 
on the card. For example, if you give up the last 256 bytes of 
expansion ROM space, your disable circuit only needs to detect 
addresses of the form $CFxx, and you can use the minimal disable- 
decoding circuitry shown in Figure 6-2. 


To RESET, ROM Enable 
Flip-Flop 





1/0 STROBE’ 


Figure 6-2 
ROM disable address decoding 


Applesoft addresses two locations in the $CFxx space, thereby 
resetting the enable flip-flop. If your peripheral device is going 
to be used with Applesoft programs, you must either use the full 
address decoding or else enable the expansion ROM each time 
it is needed. 
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Peripheral-card RAM space 


There are 56 bytes of main memory allocated to the peripheral 
cards, eight bytes per card, as shown in Table 6-3. These 56 
locations are actually in the RAM memory reserved for the text and 
low-resolution graphics displays, but these particular locations are 
not displayed on the screen and their contents are not changed by 
the built-in output routine COUT1. Programs in ROM on peripheral 
cards use these locations for temporary data storage. 


Table 6-3 
Peripheral-card RAM memory locations 
Slot number 
Base 
address 1 2 3° 4 5 6 7 


$0478 $0479 $047A $047B* $047C $047D $047E $047F 
$04F8 $04F9 $04FA $04FB* $04FC $04FD $04FE $04FF 
$0578 $0579 $057A $057B* $057C $057D $057E $057F 
$05F8 $05F9 $05FA $05FB* $05FC $05FD $05FE $05FF 
$0678 $0679 $067A $067B* $067C $067D $067E $067F 
$06F8 $06F9 $06FA $06FB* $06FC $06FD $06FE $06FF 
$0778 $0779 $077A $077B* $077C $077D $077E $077F 
$07F8 $07F9 $07FA $07FB* $07FC $07FD $07FE $07FF 


* If there is a card in the auxiliary slot, it takes over these locations. 


A program on a peripheral card can use the eight base addresses 
shown in the table to access the eight RAM locations allocated for its 
use, as shown in the next section, “I/O Programming Suggestions.” 


Warning The Apple lle firmware sets the value of $O4FB to SFF on a reset, 
even If there is no 80-column card installed. 


I/O programming suggestions 


A program in ROM on a peripheral card should work no matter 
which slot the card occupies. If the program includes a jump to an 
absolute location in one of the 256-byte memory spaces, then the 
card will work only when it is plugged into the slot that uses that 
memory space. If you are writing the program for a peripheral card 
that will be used by many people, you should avoid placing such a 
restriction on the use of the card. 
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Important 


To function properly no matter which slot a peripheral card is 
Installed in, the program in the card’s 256-byte memory space 
must not make any absolute references fo itself. Instead of 
using jump instructions, you should force conditions on branch 
instructions, which use relative addressing. 


The first thing a peripheral card used as an I/O device must do when 
called is to save the contents of the Apple Ile’s microprocessor’s 
registers. (Peripheral cards not being used as I/O devices do not 
need to save the registers.) The device should save the register’s 
contents on the stack, and restore them just before returning 
control to the calling program. If there is RAM on the peripheral 
card, the information may be stored there. 


Most single-character I/O is done via the microprocessor’s 
accumulator. A character being output through your subroutine will 
be in the accumulator with its high bit set when your subroutine is 
called. Likewise, if your subroutine is performing character input, it 
must leave the character in the accumulator with its high bit set when 
it returns to the calling program. 


Finding the slot number with ROM switched in 


The memory addresses used by a program on a peripheral card 
differ depending on which expansion slot the card is installed in. 
Before it can refer to any of those addresses, the program must 
somehow determine the correct slot number. One way to do this is 
to execute a JSR Gump to subroutine) to a location with an RTS 
(return from subroutine) instruction in it, and then derive the slot 
number from the return address saved on the stack, as shown in the 
following example. 


PHP 7; save status 

SEI ; inhibit interrupts 

JSR KNOWNRTS j; ->a known RTS instruction 
;...-that you set up 

TSX ; get high byte of the 

LDA $0100,X ; «..return address from stack 

AND #SOF + low-order digit is slot no. 

PLP ; restore status 


The slot number can now be used in addressing the memory 
allocated to the peripheral card, as shown in the next section. 
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See the section “Setting Bank 
Switches” In Chapter 4 for more 
information. 


1/O addressing 


Once your peripheral-card program has the slot number, the card 
can use the number to address the I/O locations allocated to the 
slot. Table 6-4 shows how these locations are related to 16 base 
addresses starting with $C080. Notice that the difference between 
the base address and the desired I/O location has the form $n0, 
where n is the slot number. Starting with the slot number in the 
accumulator, the following example computes this difference by 
four left shifts, then loads it into an index register and uses the base 
address to specify one of 16 I/O locations. 


ASL 7 get n into 

ASL 7 

ASL ? 

ASL j; ...shigh-order nybble 
TAX ; ...0f index register 
LDA $co08s0,X ; load from first I/O location 


“+ Selecting your target: You must make sure that you get an 
appropriate value into the index register when you address I/O 
locations this way. For example, starting with 1 in the 
accumulator, the instructions in the above example perform an 
LDA from location $C090, the first I/O location allocated to 
slot 1. If the value in the accumulator had been 0, the LDA 
would have accessed location $C080, thereby setting the soft 
switch that selects the second bank of RAM at location $D000 
and enables it for reading. 


Table 6-4 
Peripheral-card |/O base addresses 


Connector number 
Base 
address 1 2 3 4 5 6 7 


$C080 $C090 $COAO $COBO $COCO $CODO $COEO $COFO 


$C081 $C091 $COA1 $COB1 $COC1 $COD1 $COE1 $COF1 
$C082 $C092 $COA2 $COB2 $C0C2 $COD2 $COE2 $COF2 
$C083 $C093 $COA3 $COB3 $C0C3 $COD3 $COE3 $COF3 
$C084 $C094 $COA4 $COB4 $C0C4 $COD4 $COE4 $COF4 
$C085 $C095 $COAS $COBS $COC5 $CODS $COES $COFS 
$C086 $C096 $COA6 $COB6 $CO0C6 $COD6 $COE6 $COF6 
$C087 $C097 $COA7 $COB7 $COC7 $COD7 $COE7 $COF7 
$C088 $C098 $COA8 $COB8 $COC8 $COD8 $COE8 $COF8 
$C089 $C099 $COAD $COB9 $COC9 $COD9 $COED $COF9 
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Warning 


Table 6-4 (continued) 
Peripheral-card I/O base addresses 


Connector number 
Base 
address | 2 3 4 5 6 7 


$CO8A $CO9A $COAA $COBA $COCA $CODA $COEA $COFA 
$CO8B $CO9B $COAB $COBB $COCB $CODB $COEB $COFB 
$CO8C $CO9C $COAC $COBC $COCC $CODC $COEC $COFC 
$CO8D $CO9D $COAD $COBD $COCD $CODD $COED $COFD 
$CO8E $CO9E $COAE $COBE $COCE $CODE $COEE $COFE 
$CO8F $CO9F $COAF $COBF $COCF $CODF $COEF $COFF 


RAM addressing 


A program on a peripheral card can use the eight base addresses 
shown in Table 6-3 to access the eight RAM locations allocated for 
its use. The program does this by putting its slot number into the Y 
index register and using indexed addressing mode with the base 
addresses. The base addresses can be defined as constants because 
they are the same no matter which slot the peripheral card 
occupies. 


If you start with the correct slot number in the accumulator (by using 
the example shown earlier), then the following example uses all 
eight RAM locations allocated to the slot: 


TAY 

LDA $0478,Y 
STA $04F8,Y 
LDA $0578,Y 
STA $05F8,Y 
LDA $0678,Y 
STA SO6F8,Y 
LDA $0778,Y 


STA $O7F8,Y 


You must be very careful when you have your peripheral-card 
program store data at the base-address locations themselves 
since they are temporary storage locations; the RAM at those 
locations Is used by the disk operating system. Always store the 
first byte of the ROM location of the expansion slot that is 
currently active ($Cn) In location $7F8, and the first byte of the 
ROM location of the slot holding the controller card for the 
startup disk drive in location $5F8. 
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See “The Standard I/O Links” in 
Chapter 3. 


COUT] and BASICOUT are 
described in Chapter 3. 


KEYIN and BASICIN are described 
in Chapter 3. 


Changing the standard I/O links 


There are two pairs of locations in the Apple Ile that are used for 
controlling character input and output. They are called the /O 
links. In an Apple Ile running without a disk operating system, the 
I/O links normally contain the starting addresses of the standard 
input and output routines—KEYIN and COUT] if the 80-column 
firmware is not active, BASICIN and BASICOUT if the 80-column is 
active. If a disk operating system is running, one or both of the links 
will hold the addresses of the operating system input and output 
routines. 


The link at locations $36 and $37 (decimal 54 and 55) is called CSW, 
for character output swiich. Individually, location $36 is called 
CSWL (CSW Low) and location $37 is called CSWH (CSW High). 
CSW holds the starting address of the subroutine the Apple Ile is 
currently using for single-character output. This address is normally 
$FDFO, the address of routine COUT1, or $C307, the address of 
BASICOUT. 


When you issue a PR#n from BASIC or an n Control-P from the 
Monitor, the Apple Ile changes this link address to the first address 
in the ROM memory space allocated to slot number n. That address 
has the form $Cn00. Subsequent calls for character output are thus 
transferred to the program on the peripheral card. That program 
can use the instruction sequences given above to find its slot 
number and use the I/O and RAM locations allocated to it. When it 
is finished, the program can execute an RTS (return from 
subroutine) instruction to return control to the calling program, or 
jump to the output routine COUT! at location $FDFO to display the 
output character (which must be in the accumulator) on the screen, 
then let COUT! return to the calling program. 


A similar link at locations $38 and $39 (decimal 56 and 57) is called 
KSW, for keyboard input switch. Individually, location $38 is 
called KSWL (KSW low) and location $39 is called KSWH (KSW 
high). KSW holds the starting address of the routine currently being 
used for single-character input. This address is normally $FD1B, 
the starting address of KEYIN, or $C305, the address of BASICIN. 
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Important 


See the ProDOS Technical 
Reference Manual for more 
about using link addresses. 


Refer to the section on input and 
output link registers In the DOS 
Programmer’s Manual and the 
ProDOS Technical Reference 
Manual for further details. 


When you issue an IN¥n command from BASIC or an n Control-K 
from the Monitor, the Apple Ile changes this link address to $Cn00, 
the beginning of the ROM memory space that is allocated to slot 
number n. Subsequent calls for character input are thus transferred 
to the program on the accessory card. That program can use the 
instruction sequences given above to find its slot number and use 
the I/O and RAM locations allocated to it. The program should put 
the input character, with its high bit set, into the accumulator and 
execute an RTS instruction to return control to the program that 
requested input. 


When a disk operating system (ProDOS or DOS 3.3) is running, one 
or both of the standard I/O links hold addresses of the operating 
system’s input and output routines. The operating system has 
internal locations that hold the addresses of the character input and 
output routines that are currently active. 


If a program that is running with ProDOSs or DOS 3.3 changes 
the standard link addresses, either directly or via IN# and PR# 
commands, the operating system is disconnected. 


To avoid disconnecting the operating system each time a BASIC 
program initiates I/O to a slot, it should use either an IN#¥ or a PR# 
command from inside a PRINT statement that starts with a 
Control-D character. For assembly-language programs, there is a 
DOS 3.3 subroutine call to use when changing the link addresses. 
After changing CSW or KSW, the program calls this subroutine at 
location $03EA (decimal 1002). The subroutine transfers the link 
address to a location inside the operating system and then restores 
the operating system address in the standard link location. 


Other uses of |/O memory space 


The portion of memory space from location $C000 through $CFFF 
(decimal 49152 through 53247) is normally allocated to I/O and 
program memory on the peripheral cards, but there are two other 
functions that also use this memory space: the built-in self-test 
firmware and the 80-column display firmware. The soft switches that 
control the allocation of this memory space are described in the 
next section. 
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Switching |/O memory 


The built-in firmware uses two soft switches to control the allocation 
of the I/O memory space from $C000 to $CFFF. The locations of 
these soft switches, SLOTCKROM and SLOTC3ROM, are given in 
Table 6-5. 


Note: Like the display switches described in Chapter 2, these 
soft switches share their locations with the keyboard data and 
strobe functions. The switches are activated only by writing, 
and the states can be determined only by reading, as indicated 
in Table 6-5. 
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Table 6-5 
|/O memory switches 


Name 


SLOTC3ROM 


SLOTCXROM 


Location 
Function Hex Decimal Notes 
Slot ROM at $C300 $COOB 49163 -16373 Write 
Internal ROM at $C300 $COOA 49162 -16374 Write 
Read SLOTC3ROM switch $C017 49175 -16361 Read 
Slot ROM at $Cx00 $C006 49159 -16377 Write 
Internal ROM at $Cx00 $C007 49158 -16378 Write 
Read SLOTCXROM switch $C015 49173 -16363 Read 


When SLOTC3ROM is on, the 256-byte ROM area at $C300 is 
available to a peripheral card in slot 3, which is the slot normally 
used for a terminal interface. If a card is installed in the auxiliary 
slot when you turn on the power or reset the Apple Ile, the 
SLOT3ROM switch is turned off. Turning SLOTC3ROM off disables 
peripheral-card ROM in slot 3 and enables the built-in 80-column 
firmware, as shown in Figure 6-3, The 80-column firmware is 
assigned to slot-3 address space because slot 3 is normally used with 
a terminal interface, so the built-in firmware will work with 
programs that use slot 3 this way. 


The bus and I/O signals are always available to a peripheral card in 
slot 3, even when the 80-column hardware and firmware are 
operating. Thus it is always possible to use this slot for any I/O 
peripheral that does not have built-in firmware. 


When SLOTCXROM is active (high), the I/O memory space from 
$C100 to $C7FF is allocated to the expansion slots, as described 
previously. Setting SLOTCXROM inactive (ow) disables the 
peripheral-card ROM and selects built-in ROM in all of the I/O 
memory space except the part from $C000 to $COFF (used for soft 
switches and data I/O), as shown in Figure 6-3. In addition to the 
80-column firmware at $C300 and $C800, the built-in ROM includes 
firmware that performs the self-test of the Apple Ie’s hardware. 


“+ Note: Setting SLOTCXROM low enables built-in ROM in all of 
the I/O memory space (except the soft-switch area), including 
the $C300 space, which contains the 80-column firmware. 
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Original lle 


For more information about the 
$C300 firmware, see the 
Monitor ROM listing in 
Appendix J of this manual. 
Especially note the portion from 
$C300 through $C420. 


Developing cards for slot 3 


In the original Apple lle firmware, the internal slot 3 firmware was 


always switched in if there was an 80-column card (either 1K 
or 64K) in the auxiliary slot. This means that peripheral cards 
with their own ROM were effectively switched ouf of slot 3 
when the system was turned on. 


With the enhanced Apple Ile Monitor ROM, the rules are different. 
A peripheral card in slot 3 is now switched in when the system is 
started up or when Reset is pressed ifthe card’s ROM has the 
following ID bytes: 


$C305 = $38 
$C307 = $18 


The enhanced Apple Ile firmware requires that interrupt code be 
present in the $C3 page (either external or internal). A peripheral 
card in slot 3 must have the following code to support interrupts. 
After this segment, the code continues execution in the internal 
ROM at $C400. 


$C3F4: IRQDONE STA $co8s1 ;Read ROM, write RAM 
JMP SFCTA ;Jump to $F8 ROM 
IRQ 


BIT $co15s ;slot or internal ROM 
STA $C007 ;force in internal ROM 


When programming for cards in slot 3: 
You must support the AUXMOVE and XFER routines at $C311 
and $C314. 


Q Don’t use unpublished entry points into the internal $Cn00 
firmware, because there is no guarantee that they will stay the 
same. 


O If your peripheral card is a character I/O device, you must follow 
the Pascal 1.1 firmware protocol, described in the next section. 
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Table 6-6 

Peripheral-card device-class 

assignments 

Digit Device class 

$0 Reserved 

$1 Printer 

$2 Joystick or other X-Y 
input device 

$3 Serial or parallel I/O 
card 

$4 Modem 

$5 Sound or speech device 

$6 Clock 

$7 Mass storage device 

$8 80-column card 

$9 Network or bus interface 

$A Special purpose (none 
of the above) 

$B-F Reserved for future 
expansion 


Pascal 1.1 firmware protocol 


The Pascal 1.1 firmware protocol was originally developed to be 
used with Apple Pascal 1.1 programs. The protocol is followed by 
all succeeding versions of Apple II Pascal, and can be used by 
programmers using other languages as well. 


The Pascal 1.1 firmware protocol provides Apple Ile programmers 
with 
O a standard way to uniquely identify new peripheral cards 


O a standard way to address the firmware routines in peripheral 
cards 


Device identification 


The Pascal 1.1 firmware protocol uses four bytes near the beginning 
of the peripheral card’s firmware to identify the peripheral card. 


Address Value 

$Cs05 $38 (like the old Apple II Serial Interface Card) 
$Cs07 —- $18 (like the old Apple II Serial Interface Card) 
$CsOB — $01 (the generic signature of new cards) 
$CsOC _— $ci (the device signature) 


The first hexadecimal digit, c, of the device signature byte identifies 
the device class; and the second hexadecimal digit, i, of the device 
signature byte is a unique identifier for the card, used by some 
manufacturers for their cards. Table 6-6 shows the device-class 
assignments. 


For example, the Apple II Super Serial Card has a device signature 
of $31: the 3 signifies that it is a serial or parallel I/O card, and the 1 
is the low-order digit supplied by Apple Technical Support. 


Although version 1.1 of Pascal ignores the device signature, 
applications programs can use them to identify specific devices. 


I/O routine entry points 


Indirect calls to the firmware in a peripheral card are done through 
a branch table in the card’s firmware. The branch table of I/O 
routine entry points is located near the beginning of the Cs00 
address space (s being the slot number where the peripheral card is 
installed). 
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The branch table locations that Pascal 1.1 firmware protocol uses 
are as follows: 


Address Contains 


$CsOD _Initialization routine offset (required) 
$CsOE Read routine offset (required) 

$CsOF Write routine offset (required) 

$Cs10 Status routine offset (required) 

$Cs11 $00 if optional offsets follow; nonzero if not 
$Cs12 Control routine offset (optional) 

$Cs13 Interrupt handling routine offset (optional) 


Notice that $Cs11 contains $00 only if the control and interrupt 
handling routines are supported by the firmware. (For example, the 
SSC does not support these two routines, and so location $Cs11 
contains a nonzero firmware instruction.) Apple II Pascal 1.0 and 
1.1 do not support control and interrupt requests, but such requests 
are implemented in Pascal 1.2 and later versions and in ProDOS. 


Table 6-7 gives the entry point addresses and the contents of the 
65C02 registers on entry to and on exit from Pascal 1.1 I/O 
routines. 


Table 6-7 
1/O routine offsets and registers under Pascal 1.1 protocol 


Address Offset for X register Y register A register 


$CsOD Initialization 


On entry $Cs $s0 

On exit Error code (unchanged) (unchanged) 
$CsOE Read 

On entry $Cs $s0 

On exit Error code (unchanged) Character read 
$CsOF Write 

On entry $Cs $s0 Char. to write 

On exit Error code (unchanged) (unchanged) 
$Cs10 Status 

On entry $Cs $s0 Request (0 or 1) 

On exit Error code (changed) (unchanged) 
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For more about interrupt support 
In ProDOS, see the ProDOS 
Technical Reference Manual. 


For information about interrupt 
handling with Apple Pascal 1.2, 
see the Device and interrupt 
Support Tools Manual, which is 
part of the Apple Ii Device 
Support Tools package 
(A2W0014). 


Interrupts on the enhanced Apple Ile 


The original Apple Ile offered little firmware support for interrupts. 
The enhanced Apple Ile’s firmware provides improved interrupt 
support, very much like the Apple IIc’s interrupt support. Neither 
machine disables interrupts for extended periods. 


Interrupts work on enhanced Apple Ile systems with an installed 80- 
column text card (either 1K or 64K) or a peripheral card with 
interrupt-handling ROM in slot 3. Interrupts are easiest to use with 
ProDOS and Pascal 1.2 because they have interrupt support built 
in. DOS 3.3 has no built-in interrupt support. 


The new interrupt handler operates like the Apple IIc interrupt 
handler, using the same memory locations and operating 
protocols. The main purpose of the interrupt handler is to support 
interrupts in any memory configuration. This is done by saving the 
machine’s state at the time of the interrupt, placing the Apple in a 
standard memory configuration before calling your program’s 
interrupt handler, then restoring the original state when your 
program’s interrupt handler is finished. 


What is an interrupt? 


An interrupt is a hardware signal that tells the computer to stop 
what it is currently doing and devote its attention to a more 
important task. Print spooling and mouse handling are examples of 
interrupt use, things that don’t take up all the time available to the 
system, but that should be taken care of promptly to be most useful. 


For example, the Apple IIe mouse can send an interrupt to the 
computer every time it moves. If you handle that interrupt 
promptly, the mouse pointer’s movement on the screen will be 
smooth instead of jerky and uneven. 


Interrupt priority is handled by a daisy-chain arrangement using 
two pins, INT IN and INT OUT, on each peripheral-card slot. As 
described in Chapter 7, each peripheral card breaks the chain when 
it makes an interrupt request. On peripheral cards that don’t use 
interrupts, these pins should be connected together. 


The daisy chain gives priority to the peripheral card in slot 7: if this 
card opens the connection between INT IN and INT OUT, or if there 
is no card in this slot, interrupt requests from cards in slots 1 
through 6 can’t get through. Similarly, slot 6 controls interrupt 
requests (IRQ) from slots 1 through 5, and so on down the line. 
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When the IRQ’ line on the Apple Ile’s microprocessor is activated 
(pulled low), the microprocessor transfers control through the 
vector in locations $FFFE-$FFFF. This vector is the address of the 
Monitor’s interrupt handler, which determines whether the request 
is due to an external IRQ or a BRK instruction and transfers control 
to the appropriate routine via the vectors stored in memory page 3. 
The BRK vector is in locations $03F0-$03F1 and ProDOS uses the 
IRQ vector in locations $03FE-$03FF. (See Table 4-11.) The 
Monitor normally stores the address of its reset routine in the IRQ 
vector; you should substitute the address of your program’s 
interrupt-handling routine. 


Apple Pascal doesn’t use the BRK vector at $03F0-$03F1, but it does 
use the IRQ vector at $03FE-$03FF. 


Interrupts on Apple Ile series computers 


The interrupt handler built into the enhanced Apple Ile’s firmware 
saves the contents of the accumulator on the stack. (The original 
Apple IIe saves the contents of the accumulator at location $45.) 
DOS 3.3, as well as the Monitor, rely on the integrity of location 
$45, so this change lets both DOS 3.3 and the Monitor continue to 
work with active interrupts on the enhanced Apple Ile. 


Original lle Since the built-in interrupt handler on the original Apple lle uses 
location $45 to save the contents of the accumulator, the 
operating system fails when an interrupt occurs under DOS 3.3 
on the original Apple lle. 


If you want to write programs that use interrupts while running on the 
original Apple Ile, Apple II Plus, or Apple II, you must use either 
ProDOS or Apple II Pascal 1.2 (or later versions). Both these 
operating systems give you full interrupt support, even though these 
versions of the Apple II don’t include interrupt support in their 
firmware. (Versions of Pascal before 1.2 do not work with interrupts 
enabled on an original Apple Ile.) 


Some other manufacturer’s hardware, such as coprocessor cards, 
don’t work properly in an interrupting environment. If you are 
trying to develop an application and encounter this problem, check 
with the manufacturer of the card to see if a later version of the 
hardware or its software will operate properly with interrupts active. 
You may not be able to use interrupts if an interrupt-tolerant 
version isn’t available. 
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Original Ile 


Important 


Interrupts are effective only if they are enabled most of the time. 
Interrupts that occur while interrupts are disabled will not be 
serviced. 


Pascal, DOS 3.3, and ProDOS turn off interrupts while performing 
disk operations because of the critical timing of disk read and write 
operations. Some peripheral cards used in the Apple Ie disable 
interrupts while reading and writing. 


Although the enhanced Apple lle firmware never disables 
interrupts during screen handling, the original Apple lle 
periodically turns interrupts off while doing 80-column screen 
operations. The effect is most noticeable while the screen is 
scrolling. 


Don‘t use PR#6 to restart your Apple Ile while running ProDOSs 


with interrupts enabled since PR#6 doesn’t disable interrupts. If 
you try It, ProDOS will fail as it starts up since its interrupt 
handlers aren‘t yet set up. If you have to restart, use Control- 
Reset or make sure that your program disables interrupts before 
it ends. 


Rules of the interrupt handler 


Unlike the Apple IIc, the enhanced Apple Ie’s interrupt-handling 
firmware is not always switched in. Here are the reasons why this is 
so and the implications that necessarily follow. 


There is mo part of memory in the Apple Ile that is always switched 
in. Thus, there is no location for an interrupt handler that works for 
all memory configurations. However, the $C3 page of firmware is 
present on all systems that have 80-column text cards in their 
auxiliary slots, so it was selected as the starting location of the built- 
in interrupt-handling routine. 


There are two factors that determine if the $C3 firmware is switched 
in and therefore whether or not interrupts will be usable: 
0 Is there an 80-column text card in the auxiliary slot? 


O If not, is there a peripheral card in slot 3 with built-in ROM with 
bytes $C305 = $38 and $C307 = $18? 
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The Apple Ile’s memory is switched according to the following rules 
at both powerup and reset: 


O If there is a ROM card in slot 3, but no text card in the auxiliary 
slot, the firmware on the ROM card is switched in. This is 
necessary for Pascal to work. 


O If there is a text card in the auxiliary slot, but no ROM card in 
slot 3, the internal $C3 firmware is switched in. 


0 If there is both a text card in the auxiliary slot and a ROM card in 
slot 3, the firmware on the ROM card is switched in. 


Important These rules mean that systems without 80-column text cards in 
the auxiliary slot do not have their Internal $C3 firmware 


See the section “Developing switched in. Such systems cannot handle interrupts or breaks 
a path Slot 3° earlier in this (the software equivalent of interrupts). An application program 


must swap In the $C3 firmware both on initialization and after 
reset to make Interrupts function properly on such a machine 
configuration. (ProDOS versions 1.1 and later do this for you 
during startup.) 


Another implication of the decision to have interrupt code in the 
$C3 page affects the shared $C800 space in the Apple Ile. When the 
$C3 page is referenced, the Ile hardware automatically switches in 
its own $C800 space. When the interrupt handler finishes, it 
restores the $C800 space to the original owner using 

MSLOT ($07F8). This means that it is very important for a 
peripheral card to place its slot address in MSLOT to support 
interrupts while code is being executed in its $C800 space. 


Interrupt handling on the 65C02 and 6502 


There are three possible conditions that will allow interrupts on the 
65C02 and 6502: 


O The IRQ line on the microprocessor is pulled low after a CLI 
instruction has been used (interrupts are not masked). This is the 
standard technique that devices use when they need immediate 
attention. 


O The microprocessor executes a break instruction (BRK = 
opcode $00). 


o A nonmaskable interrupt (NMD occurs. The microprocessor 
services this interrupt whether or not the CLI instruction has been 
used. An NMI is completely independent of the interrupts 
discussed in this manual. 
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Interrupt-handier installation is 
described in the ProDOS 
Technical Reference Manual and 
the Device and Interrupt Support 
Tools Manual, which is part of 
the Apple Il Device Support Tools 
package (A2W0014). 


The microprocessor saves the current program counter and status 
byte on the stack when an interrupt occurs and then jumps to the 
routine whose address is stored in $FFFE and $FFFF. The sequence 
of operations performed by the microprocessor is as follows: 


1. It finishes executing the current instruction if an IRQ is 
encountered. (If a BRK instruction is encountered, the current 
instruction is already finished.) 


. It pushes the high byte of the program counter onto the stack. 
. It pushes the low byte of the program counter onto the stack. 
. It pushes the processor status byte onto the stack. 

. It executes a JMP ($FFFE) instruction. 


WM me WwW HN 


The interrupt vector at $FFFE 


Three separate regions of memory contain address $FFFE in an 
Apple Ile with an Extended 80-Column Text Card: the built-in 
ROM, the bank-switched memory in main RAM, and the bank- 
switched memory in auxiliary RAM. The vector at $FFFE in the ROM 
points to the built-in interrupt handling routine. You must copy the 
ROM’s interrupt vector to the other banks yourself if you plan to use 
interrupts with the bank-switched memory switched in. 


The built-in interrupt handler 


The enhanced Apple Ile’s built-in interrupt handler records the 
computer’s current memory configuration, then sets the 
computer’s memory configuration to a standard state so that your 
program’s interrupt handler always begins running in the same 
memory configuration. 


Next the built-in interrupt handler checks to see if the interrupt was 
caused by a break instruction, and handles it as just described under 
“Interrupt Handling on the 65C02 and 6502.” If it was not a break, it 
passes control to the interrupt-handling routine whose address is 
stored at $3FE and $3FF of main memory. Normally, that would be 
the operating system’s interrupt handler, unless you have installed 
one of your own. 


After your program’s interrupt handler returns (with an RTD, the 
built-in interrupt handler restores the memory configuration, and 
then does another RTI to return to where it was when the interrupt 
occurred. Table 6-8 illustrates this entire process. Each of these 
steps is explained later in this chapter. 
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Table 6-8 
Interrupt-handling sequence 


Interrupted 
program Processor Built-in handler User’s handler 


Program—»Push address 
Push status 


JMP ($FFFE)— Save old and set 
new memory 
configuration 


If BRK, then go 
to break handler 
($FA47)—_—————___—_"—- 


Our interrupt? 


NO: Push address 
Push status 
JMP ($3FE)— Handle interrupt 


YES: Handle it 


Restore memory~—RTI 
configuration 


Pull status <——RTI 
Program~—Pull address 


Saving the Apple Ile’s memory configuration 


The built-in interrupt handler saves the Apple Ile’s memory 
configuration and then sets it to a known state according to these 
rules: 


O Text Page 1 is switched in (PAGE2 off) so that main screen holes 
are accessible if 80STORE and PAGE2 are on. 


Main memory is switched in for reading (RAMRD off). 

Main memory is switched in for writing (RAMWRT off). 
$D000-$FFFF ROM is switched in for reading (RDLCRAM off). 
Main stack and zero page are switched in (ALTZP off). 


OO bh eo ou 





The auxiliary stack pointer is preserved, and the main stack 
pointer is restored. (See the next section, “Managing Main and 
Auxiliary Stacks.”) 


152 Chapter 6: Programming for Peripheral Cards 


Important 


Important 


Because main memory Is switched in, all memory addresses 
used later in this chapter are in main memory unless otherwise 
specified. 


Managing main and auxiliary stacks 


Apple has adopted a convention that allows the Apple Ile to be run 
with two separate stack pointers since the Apple Ile with an Extended 
80-Column Text Card has two stack pages. Two bytes in the auxiliary 
stack page are used as storage for inactive stack pointers: $0100 for 
the main stack pointer when the auxiliary stack is active, and $0101 
for the auxiliary stack pointer when the main stack is active. 


When a program using interrupts switches in the auxiliary stack for 
the first time, it must place the value of the main stack pointer at 
$0100 (in the auxiliary stack) and initialize the auxiliary stack pointer 
to $FF (the top of the stack). When it subsequently switches from 
one stack to the other, it must save the current stack pointer before 
loading the pointer for the other stack. 


The current stack pointer is stored at $0101, and the main stack 
pointer is retrieved from $0100 when an interrupt occurs while the 
auxiliary stack is switched in. Then the main stack is switched in. The 
stack pointer is restored to its original value after the interrupt has 
been handled. 


The built-in XFER routine does not support this procedure. If you 


are using XFER to swap stacks, you must use code like the 
following to set up the stack pointers and stack. 


Interrupts on the enhanced Apple lie 153 


* This example transfers control from a code segment running 


* using the main stack to one running using the aux stack. 
* 


1 XFERALT PHP ;preserve interrupt status in A 
2 PLA 
3 SEI ;disable interrupts 
4 TSX psave main stack pointer at $100 
5 STA SETALTZP sand swap zero pages 
6 STX $100 
7 LDX $101 jnow restore aux stack pointer 
8 TXS 
9 PHA jand interrupt status 
10 PLP 
11 LDA #DESTL ;set destination address 
12 STA $3ED 
13 LDA #DESTH 
14 STA $3EE 
15 SEC/CLC ;set direction of transfer 
16 BIT RTS ;V=1 for alt zero page (RTS=$60) 
17 JMP XFER ;do transfer 
To transfer control the other direction, change the following lines 
5 STX $101 
6 LDX $100 
q STA SETSTDZP 


16 CLV ;V=0 for main zp 


The user’s interrupt handler at $3FE 


If your program has an interrupt handler, it must place the entry 
address of that handler at $03FE. After it sets the machine to a 
standard state, the IIe’s internal interrupt handler transfers control 
to the routine whose address is in the vector at $03FE. 


It is very important for a peripheral card to place its slot address in 
MSLOT to support interrupts whenever it is executing code in its 
$C800 space. Whenever the $C3 page is referenced, the Ile 
automatically switches in its own $C800 ROM space. When the 
interrupt handler finishes, it restores the $C800 space to the 
original owner using MSLOT ($07F8). 


Warning _ Be careful to install Interrupt handlers according to the rules of 
the operating system that you are using. Placing the address of 
your program’s interrupt handler at $O3FE disconnects the 
operating system’s interrupt handler. 
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Table 6-9 


BRK handler information 


Information 
Program counter 
dow byte) 


Program counter 


chigh byte) 


Encoded memory 
state 


Accumulator 
X register 
Y register 


Status register 


Location 


$3A 


$3B 


$44 


$45 
$46 
$47 
$48 


The $03FE interrupt handler must do these things: 

1. Verify that the interrupt came from the expected source. 
2. Handle the interrupt as desired. 

3, Clear the appropriate interrupt soft switch. 

4, Return with an RTI. 


Here are some things to remember if you are dealing with programs 
that must run in an interrupt enviroment: 


O There is no guaranteed maximum response time for interrupts 
because the system may be doing a disk operation that lasts for 
several seconds. 


O Once the built-in interrupt handler is called, it takes at least 
150 to 200 microseconds for it to call your interrupt-handling 
routine. After your routine returns, it takes 40 to 140 
microseconds to restore memory and return to the interrupted 
program. 


O If memory is in the standard state when the interrupt occurs, the 
total overhead for interrupt processing is about 
150 microseconds less than if memory is in the worst state. (The 
worst state is one that requires the most work to set up for: 
8OSTORE and PAGE2 on; auxiliary memory switched in for 
reading and writing; bank-switched memory page 2 in the 
auxiliary bank switched in for reading and writing, and internal 
$Cn00 ROM switched in). 


O Interrupt overhead will be greater if your interrupt handler is 
installed through an operating system’s interrupt dispatcher. The 
length of delay depends on the operating system, and on 
whether the operating system dispatches the interrupt to other 
routines before calling yours. 


Handling break instructions 


The 65C02 treats a break instruction (BRK, opcode $00) just like a 
hardware interrupt. After the interrupt handler sets the memory 
configuration, it checks to see if the interrupt was caused by a break 
(bit 4 of the status byte is set) and, if it was, jumps to a break- 
handling routine. This routine saves the state of the computer at the 
time of the break as shown in Table 6-9. 


Finally the break routine jumps to the routine whose address is 
stored at $3FO and $3F1. 


The encoded memory state in location $44 is interpreted as shown 
in Table 6-10. 
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Table 6-10 
Memory configuration information 


Bit7=1 _ if auxiliary zero page and auxiliary stack are switched in 
Bit6=1 if 8SOSTORE and PAGE2 both on 

BitS=1 if auxiliary RAM switched in for reading 

Bit4=1 _ if auxiliary RAM switched in for writing 

Bit3 =1 if bank-switched RAM being read 


Bit2=1 if bank-switched $D000 Page 1 switched in and 
RAMREAD set 


Bitl=1 if bank-switched $D000 Page 2 switched in and 
RAMREAD set 


BitO=1 if internal Cs ROM was switched in (le only) 


Interrupt differences: Apple Ile versus Apple llc 


If you are writing software for both the Apple Ile and the Apple IIc, 
you should know that there are several important differences 
between the interrupts on the enhanced Apple Ile and those on the 
Apple IIc. They are the following: 


O In the Apple IIc ROM, $FFFE points to $C803; in the Apple Ie 
ROM, to $C3FA. To ensure that the proper interrupt vectors are 
placed into the Language Card RAM space, always copy them to 
the RAM from the ROM. (When you initialize built-in devices on 
the IIc, these vectors are automatically updated). 


O There is no shared $C800 ROM in the Apple IIc. Peripheral cards 
share this space in the Apple IIe. Thus it is crucial that the slot 
address of the peripheral card using the $C800 space is stored in 
MSLOT ($07F8). When the interrupt handler goes to the internal 
$C3 space, the Ile hardware switches in its own $C800 space. 
When the interrupt handler finishes, it restores the $C800 space 
to the slot whose address is in MSLOT. 


0 The Apple IIc $C800 space is always switched in. The enhanced 
Apple Ile’s interrupt handler preserves the state of the $C800- 
space switch and then switches in the slot I/O space. This means 
that when restoring the state of the system using the value placed 
in location $44, break-handling routines must restore one more 
value on the Apple Ile than on the Apple IIc. 
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Chapter 7 


Hardware 
Implementation 
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Extended keyboard Ile 


Table 7-1 

Summary of environmental 
specifications 

Operating 10° to 40° C 
temperature (50° to 104° FP) 
Relative 10% to 90% 
humidity 


Line voltage 95 to 127 VAC 


Most of this manual describes functions—what the Apple Ile does. 
This chapter, on the other hand, describes objects—the pieces of 
hardware the Apple Ile uses to carry out its functions. If you are 
designing a piece of peripheral hardware to attach to the Apple Ie, 
or if you just want to know more about how the Apple Ie is built, you 
should study this chapter. 


Because the extended keyboard Ile uses several new 
components and includes the Extended 80-Column Text Card 
as a standard feature, its schematic diagram Is slightly different 
from that of the original and enhanced lle’s. The schematic for 
the extended keyboard lle is provided in Figure 7-16a-d at the 
end of this chapter. If you have an extended keyboard Ile you 
should refer to this schematic whenever the text refers to the 
schematic for the original and the enhanced lle’s 

(Figure 7-15a-d). 


Environmental specifications 


The Apple Ile is quite sturdy when used in the way it was intended. 
Table 7-1 defines the conditions under which the Apple Ile is 
designed to function properly. 


You should treat the Apple Ile with the same kind of care as any 
other electrical appliance. You should protect it from physical 
violence, such as hammer blows or defenestration. You should 
protect the mechanical keyboard and the electrical connectors 
inside the case from spilled liquids, especially those with dissolved 
contaminants, such as coffee and cola drinks. 


In normal operation, enough air flows through the slots in the case 
to keep the insides from getting too hot, although some of the parts 
inside the Apple Ile normally get rather warm to the touch. If you 
manage to overheat your Apple IIe, by blocking the ventilation slots 
in the top and bottom for example, the first symptom will be erratic 
operation. The memory devices in the Apple Ile are sensitive to 
heat: when they get too hot, they occasionally change a bit of data. 
The exact result depends on what kind of program you are running 
and on just which bit of memory is affected. 
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The power supply 


The power supply in the Apple Ile operates on normal household 
AC power and provides enough low-voltage electrical power for the 
built-in electronics plus a full complement of peripheral cards, 
including disk controller cards and communications interfaces. 
The basic specifications of the power supply are listed in Table 7-2. 


The Apple Ile’s power cord should be plugged into a three-wire 110- 
to 120-volt outlet. You must connect the Apple Ile to a grounded 
outlet or to a good earth ground. In addition, the line voltage must 
be in the range given in Table 7-2. If you try to operate the Apple Ile 
from a power. source with more than 127 volts AC, you will damage 
the power supply. 


Table 7-2 

Power supply specifications 

Line voltage 97 to 127VAC 
Maximum power 60W continuous 
consumption 80W intermittent* 


Supply voltages +5V 43% 
+11.8V +6% 


-5.2V +10% 
—12V +10% 
Maximum supply +5V: 2.5A 
currents +12V: 1.5A continuous, 
2.5A intermittent* 
-5V: 250mA 
—12V: 250mA 
Maximum case 40° C (104° F) 
temperature 


* Intermittent operation: The Apple Ile can safely 
operate for up to 20 minutes at the higher load if 
followed by at least 10 minutes at normal load. 


The Apple Ile uses a custom-designed switching-type power supply. 


It is small and lightweight, and it generates less heat than other types 
of power supplies do. 
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Warning 


The Apple Ie’s power supply works by converting the AC line 
voltage to DC and using this DC voltage to power a variable- 
frequency oscillator. The oscillator drives a small transformer with 
many separate windings to produce the different voltages required. 
A circuit compares the voltage of the +5-volt supply with a reference 
voltage and feeds an error signal back to the oscillator circuit. The 
oscillator circuit uses the error signal to control the frequency of its 
oscillation and keep the output voltages in their normal ranges. 


The power supply includes circuitry to protect itself and the other 
electronic parts of the Apple He by turning off all four supply 
voltages whenever it detects one of the following malfunctions: 


O any supply voltage short-circuited to ground 
O the power-supply cable disconnected 
O any supply voltage outside the normal range 


Any time one of these malfunctions occurs, the protection circuit 
stops the oscillator, and all the output voltages drop to zero. After 
about half a second, the oscillator starts up again. If the malfunction 
is still occurring, the protection circuit stops the oscillator again. 
The power supply will continue to start and stop this way until the 
malfunction is corrected or the power is turned off. 


If you think the power supply Is broken, do not attempt to 
repair it yourself. The power supply Is in a sealed enclosure 
because some of its circuits are connected directly to the 
power line. Special equipment is needed to repair the power 
supply safely, so see your authorized Apple dealer for service. 


The power connector 


The cable from the power supply is connected to the main circuit 
board by a six-pin connector with a strain-relief catch. The 
connector pins are identified in Table 7-3 and Figure 7-15d (or 
Figure 7-16d for the extended keyboard Ile). 


Table 7-3 

Power connector signal specifications 

Pin Signal Description 

1,2 Ground Common electrical ground 
3 +5V +5V from power supply 

4 +12V +12V from power supply 

5 -12V -12V from power supply 

6 —-5V —5V from power supply 
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See Appendix A for a description 
of the 65C02’s instruction set 
and electrical characteristics. 


The 65C02 microprocessor 


The enhanced Apple Ile uses a 65C02 microprocessor as its central 
processing unit (CPU). The 65C02 in the Apple Ile runs at a clock 
rate of 1.023 MHz and performs up to 500,000 eight-bit operations 
per second. You should not use the clock rate as a criterion for 
comparing different types of microprocessors. The 65C02 has a 
simpler instruction cycle than most other microprocessors and it 
uses instruction pipelining for faster processing. The speed of the 
65C02 with a 1MHz clock is equivalent to other types of 
microprocessors with clock rates up to 2.5MHz. 


The 65C02 has a 16-bit address bus, giving it an address space of 
64K (2 to the 16th power, or 65,536) bytes. The Apple Ile uses 
special techniques to address outside of this range: see the sections 
“Bank-Switched Memory” and “Auxiliary Memory and Firmware” 
in Chapter 4 and the section “Switching I/O Memory” in Chapter 6. 


Table 7-4 

65C02 microprocessor specifications 
Type 65C02 

Register 8-bit accumulator (A) 


complement 8-bit index registers (X,Y) 
8-bit stack pointer (S) 
8-bit processor status (P) 


16-bit program counter (PC) 


Data bus . 8 bits wide 
Address bus 16 bits wide 
Address range 65,536 (64K) 
Interrupts IRQ (maskable) 


NMI] (nonmaskable) 
BRK (programmed) 


+5V G 5%) 
5 mW (at 1 MHz) 


Operating voltage 


Power dissipation 
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65C02 timing 

The operation of the Apple Ile is controlled by a set of synchronous 
timing signals, sometimes called clock signals. In electronics, the 
word clock is used to identify signals that control the timing of 
circuit operations. The Apple Ile doesn’t contain the kind of clock 
you tell time by, although its internal timing is accurate enough that 
a program running on the Apple Ile can simulate such a clock. 


The frequency of the oscillator that generates the master timing 
signal is 14.31818 MHz. Circuitry in the Apple Ie uses this clock 
signal, named 14M, to produce all the other timing signals. These 
timing signals perform two major tasks: controlling the computing 
functions, and generating the video display. The timing signals 
directly involved with the operation of the 65C02 (and 6502 on the 
original version of the Apple Ile) are described in this section. 
Other timing signals are described in this chapter in the sections 
“RAM Addressing,” “Video Display Modes,” and “The Expansion 
Slots.” 


The main 65C02 timing signals are listed in Table 7-5, and their 
relationships are diagrammed in Figure 7-1. The 65C02 clock 
signals are g1 and @0, complementary signals at a frequency of 
1.02273 MHz. The Apple Ue signal named @0 is equivalent to the 
signal called @2 in the hardware manual. (It isn’t identical: it’s a few 
nanoseconds early.) 


The operations of the 65C02 are related to the clock signals in a 
simple way: address during #1, data during a0. The 65C02 puts an 
address on the address bus during @1. This address is valid not later 
than 140 nanoseconds after @1 goes high and remains valid through 
all of a0. The 65C02 reads or writes data during @0. If the 65C02 is 
writing, the read/write signal is low during @0 and the 65C02 puts 
data on the data bus. The data is valid not later than 75 
nanoseconds after @0 goes high. If the 65C02 is reading, the 
read/write signal remains high. Data on the data bus must be valid 
no later than 50 nanoseconds before the end of 90. 
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Figure 7-1 
65C02 timing signals 


Table 7-5 
65C02 timing signal descriptions 


Signal Description 


14M Master oscillator, 14.318 MHz; also 80-column dot clock 


VID7M Intermediate timing signal and 40-column dot clock 


Q3 Intermediate timing signal, 2.045 MHz with 
asymmetrical duty cycle 
20 Phase 0 of 65C02 clock, 1.0227 MHz; complement of @1 
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The custom integrated circuits 


Most of the circuitry that controls memory and I/O addressing in 
the Apple Ile is in three custom integrated circuits called the 
Management Unit (MMU), the Input/Output Unit (OU), and the 
Programmed Array Logic device (PAL). The soft switches used for 
controlling the various I/O and addressing modes of the Apple Ile 
are addressable flags inside the MMU and the IOU. The functions of 
these two devices are not as independent as their names suggest, 
working together, they generate all of the addressing signals. For 
example, the MMU generates the address signals for the CPU, while 
the IOU generates similar address signals for the video display. 


The Memory Management Unit 


The circuitry inside the Memory Management Unit (MMU) 
implements these soft switches, which are described in the 
indicated chapters in this manual: 


O Page 2 display (PAGE2): Chapter 2 

O high-resolution mode (HIRES): Chapter 2 

O store to 80-column card (8OSTORE): Chapter 2 

0 select bank 2: Chapter 4 

O enable bank-switched RAM: Chapter 4 

O read auxiliary memory (RAMRD): Chapter 4 

O write auxiliary memory (RAMWRT): Chapter 4 

O auxiliary stack and zero page (ALTZP): Chapter 4 

O slot ROM for connector #3 (SLOTC3ROM): Chapter 6 
O slot ROM in I/O space (SLOTCKROM): Chapter 6 


The 64K dynamic RAMs used in the Apple Ile use a multiplexed 
address, as described later in this chapter in the section “Dynamic- 
RAM Timing.” The MMU generates this multiplexed address for 
memory reading and writing by the 65C02 CPU. The pinouts and 
signal descriptions of the MMU are shown in Figure 7-2 and 

Table 7-6. 
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Figure 7-2 
MMU pinouts 
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Table 7-6 
MMU signal descriptions 


Pin Signal Description 

1 GND Power and signal common 

2 AO 65C02 address input 

3 20 Clock phase 0 input 

4 Q3 Timing signal input 

5 PRAS’ Memory row-address strobe 

6-13 RAO-RA7 Multiplexed address output 

14 R/W’ 65C02 read-write control signal 

15 INH’ Inhibits main memory (tied to +5V) 
16 DMA’ Controls data bus for DMA transfers 
17 EN80’ Enables auxiliary RAM 

18 KBD’ Enables keyboard data bits 0-6 

19 ROMEN2’ Enables ROM (tied to ROMEN1’) 

20 ROMEN1’ Enables ROM (tied to ROMEN2’) 

21 MD7 State of MMU flags on data bus bit 7 
22 RW’ 245 Controls 74LS245 data-bus buffer 
23 RAMEN’ Enables main RAM 

24 Cxxx Enables peripheral-card memory 
25 +5V Power 

26-40 A15-A1 65C02 address input 

The Input/Output Unit 


The circuitry inside the Input/Output Unit GOU) implements the 
following soft switches, all described in Chapter 2 in this manual: 


Page 2 display (PAGE2) 
high-resolution mode (HIRES) 

text mode (TEXT) 

mixed mode (MIXED) 

80-column display (80COL) 

text display mode select (ALTCHAR) 
any-key-down 

annunciators 

vertical blanking (VBL) 


GE tt 8 ee a ee 
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GND 1 
GR| 2 
SEGA] 38 
SEGB | 4 
vC 5 
80VID’ | 6 
CASSO | 7 
SPKR | 8 
MD7 9 
ANO | 10 
ANI } 11 
AN2 | 12 
AN3 | 18 
R/W’ | 14 
RESET’ | 15 
(ne.) | 16 
RAO | 17 
RAl | 18 
RA2 | 19 
RA3 | 20 
Figure 7-3 
IOU pinouts 





The 64K dynamic RAMs used in the Apple Ile require a multiplexed 
address, as described later in this chapter in the section “Dynamic- 
RAM Timing.” The IOU generates this multiplexed address for the 
data transfers required for display and memory refresh during clock 
phase 1. The way this address is generated is described later in this 
chapter in the section “Display Address Mapping.” The pinouts 
and signal descriptions for the IOU are shown in Figure 7-3 and 
Table 7-7. 


Table 7-7 

IOU signal descriptions 

Pin Signal Description 

1 GND Power and signal common 

2 GR Graphics mode enable 

3 SEGA In text mode, works with VC (See pin 5) 
and SEGB to determine character row 
address 

4 SEGB In text mode, works with VC (see pin 5) 


and SEGA; in graphics mode, selects 
high resolution when low, low 
resolution when high 


5 vc Display vertical counter bit: in text 
mode, SEGA, SEGB, and VC 
determine which of the eight rows of a 
character’s dot pattern to display; in 
low resolution, selects upper or lower 


block defined by a byte 
6 SOVID’ 80-column video enable 
7 CASSO Cassette output signal 
8 SPKR Speaker output signal 
9 MD7 Internal IOU flags for data bus (bit 7)3 
10-13 ANO-AN3 Annunciator outputs 
14 R/W’ 65C02 read-write control signal 
15 RESET’ Power on and reset output 
16 (Nothing is connected to this pin.) 
17-24 RAO-RA7 Video refresh multiplexed RAM 


address (phase 1) 
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Figure 7-4 
PAL pinouts 





Table 7-7 (continued) 
IOU signal descriptions 


Pin 


25 
26 
27 
28 
29 
30 
31 
32 
35) 54 
35,36 
37 
38 
39 
40 


Signal 


PRAS’ 

20 

Q3 

+5V 

A6 

COxx 

AKD 
KSTRB 
VIDD7,VIDD6 
RA9’,RA10’ 
CLRGAT’ 
WNDW’ 
SYNC’ 

HO 


The PAL device 


A Programmed Array Logic device, type PAL 16R8, generates 
several timing and control signals in the Apple IIe. These signals 
are listed in Table 7-8. The PAL pinouts are given in Figure 7-4. 


Table 7-8 
PAL signal descriptions 


Pin 


OMAN AWN KRWDN PR 


Signal 


14M 

7M 
3.58M 
HO 
VID7 
SEGB 
GR 
RAMEN’ 
80VID’ 


Description 


Row-address strobe (phase 0) 
Master clock phase 0 
Intermediate timing signal 
Power 

Address bit 6 from 65C02 

I/O address enable 
Any-key-down signal 
Keyboard strobe signal 
Video display data bits 

Video display control bits 
Color-burst gate (enable) 
Display blanking signal 
Display synchronization signal 


Display horizontal timing signal 
dow bit of character counter) 


Description 


14.31818 MHz master timing signal 
7.15909 MHz timing signal 

3.579545 MHz timing signal 
Horizontal video timing signal 
Video data bit 7 

Video timing signal 

Video display graphics-mode enable 
RAM enable (CAS enable) 

Enable 80-column display mode 
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+5V 1 +5V 
Al2 2 +5V 
AT 3 +5V 
A6 4 A8 
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MD1 MD5 
MD2 MD4 
GND MD3 





Figure 7-5 
2364 ROM pinouts 


Table 7-8 (continued) 
PAL signal descriptions 


Pin Signal Description 

10 GND Power and signal common 

11 ENTMG Enable master timing 

12 LDPS’ Video shift-register load enable 
13 VID7M Video dot clock, 7 or 14 MHz 
14 == Phase 1 system clock 

15 gO Phase 0 system clock 

16 Q3 Intermediate timing and strobe signal 
17 PCAS’ RAM column-address strobe 
18 N.C. (This pin is not used.) 

19 PRAS’ RAM row-address strobe 

20 +5V Power 


Memory addressing 


The Apple Ile’s microprocessor can address 65,536 locations. 
Apple Ile uses this entire address space, and then some: some areas 
in memory are used for more than one function. The following 
sections describe the memory devices used in the Apple Ile and the 
way they are addressed. Input and output also use portions of the 
memory address space; refer to the section “Peripheral-Card 
Memory Spaces” in Chapter 6 for information. 


ROM addressing 


In the original and the enhanced Apple Ile’s, the following 
programs are permanently stored in two type 2364 8K by seven-bit 
ROMs (read-only memory): 

O Applesoft editor and interpreter 

O System Monitor 

O 80-column display firmware 


O self-test routines 


These two ROMs are enabled by two signals named ROMEN]1 and 
ROMEN2. The ROM enabled by ROMEN1, sometimes called the 
Diagnostics ROM, occupies the memory address space from $C100 
to $DFFF. The address space from $C300 to $C3FF and from $C800 
to $CFFF contains the 80-column display firmware. Those address 
spaces are normally assigned to ROM on a peripheral card in slot 3. 
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Extended keyboard Ile 
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23128 ROM pinouts 
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Figure 7-7 
2316 ROM pinouts 





+5V 
A8& 
A9 
+5V 
KBD’ 
GND 
ENKBD’ 
(n.c.) 
MD6 
MD5 
MD4 
MD3 


For a discussion of the way the 80-column firmware overrides the 
peripheral card, see the section “Other Uses of I/O Memory Space’ 
in Chapter 6. The pinouts of the 2364 ROMs are given in Figure 7-5. 


The extended keyboard Ile has the same programs stored in 
ROM as the original and enhanced Ile’s do. However, the 
extended keyboard lle uses a single 23128 IC (128K ROM) 
instead of the two 2364 ICs used in the original and the 
enhanced lle. This new ROM IC is enabled by the ROMEN signal, 
which Is a logical AND of the ROMEN1] and ROMEN2 signals. The 
pinout diagram for the 23128 ROM is given in Figure 7-6. 


Two other portions of the Diagnostics ROM, addressed from $C100 
to $C2FF and from $C400 to $C7FF, contain the built-in self-test 
routines. These address spaces are normally assigned to the 
peripheral cards; when the self-test programs are running, the 
peripheral cards are disabled. 


The remainder of the Diagnostics ROM, addressed from $D000 to 
$DFFF, contains part of the Applesoft BASIC interpreter. 


The ROM enabled by ROMEN2, sometimes called the Monitor 
ROM, occupies the memory address space from $E000 to $FFFF. 
This ROM contains the rest of the Applesoft interpreter, in the 
address space from $E000 to $EFFF, and the Monitor subroutines, 
from $F000 to $FFFF. 


The other ROMs in the Apple Ile are a type 2316 ROM used for the 
keyboard character decoder and a type 2333 ROM used for 
character sets for the video display. This 2333 ROM is rather large 
because it includes a section of straight-through bit-mapping for the 
graphics modes. This way, graphics display video can pass through 
the same circuits as text without additional switching circuitry. The 
2316’s pinout is given in Figure 7-7, and the 2333’s pinout is given in 
Figure 7-8. 


RAM addressing 


The RAM (programmable memory) in the Apple Ile is used to store 
both programs (along with their associated data) and the video 
display. The RAM in both the original and the enhanced Ile consists 
of eight 64Kx1 RAM ICs (Figure 7-9). The RAM in the extended 
keyboard Ile consists of two 64Kx4 RAM ICs (Figure 7-10). 
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Figure 7-8 
2333 ROM pinouts 
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Figure 7-9 
64Kx1 RAM pinouts 
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Figure 7-10 
64Kx4 RAM pinouts 











The areas in RAM that are used for the display are accessed both by 
the 65C02 microprocessor and by the video display circuits. In 
some computers, this dual access results in addressing conflicts 
(cycle stealing) that can cause temporary dropouts in the video 
display. This problem does not occur in the Apple Ile, thanks to the 
way the microprocessor and the video circuits share the memory. 


The memory circuits in the Apple Ile take advantage of the two- 
phase system clock described earlier in this chapter in the section 
“65C02 Timing” to interleave the microprocessor memory accesses 
and the display memory accesses so that they never interfere with 
each other. The microprocessor reads or writes to RAM only during 
@0, and the display circuits read data only during 91. 


Dynamic-RAM refreshment 


The image on a video display is not permanent; it fades rapidly and 
must be refreshed periodically. To refresh the video display, the 
Apple Ile reads the data in the active display page and sends it to the 
display. To prevent visible flicker in the display, and to conform to 
standard practice for broadcast video, the Apple Ile refreshes the 
display 60 times per second. 


The dynamic RAM devices used in the Apple Ile also need a kind of 
refresh, because the data is stored in the form of electric charges, 
which diminish with time and must be replenished every so often. 
The Apple Ile is designed so that refreshing the display also 
refreshes the dynamic RAMs. The next few paragraphs explain how 
this is done. 


The job of refreshing the dynamic RAM devices is minimized by the 
structure of the devices themselves. The individual data cells in 
each RAM device are arranged in a rectangular array of rows and 
columns. When the device is addressed, the part of the address that 
specifies a row is presented first, followed by the address of the 
column. Splitting information into parts that follow each other in 
time is called multiplexing. Because only half of the address is 
needed at one time, multiplexing the address reduces the number 
of pins needed for connecting the RAMs. 


Different manufacturers’ 64K RAMs have cell arrays of either 128 
rows by 512 columns or 256 rows by 256 columns. Only the row 
portion of the address is used in refreshing the RAMs. 
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Table 7-9 


RAM address multiplexing 


Mux’d 
address 


"RAO 
RA1 
RA2 
RA3 
RA4 
RAS 
RA6 
RA7 


Row 
address 


AO 
Al 
A2 
A3 
A4 
A5 
A7 
A8 


Column 
address 


AQ 

A6 

A10 
All 
A12 
Al3 
Al4 
A15 


Now consider how the display is refreshed. As described later in this 
chapter in the section “The Video Counters,” the display circuitry 
generates a sequence of 8,192 memory addresses in high-resolution 
mode; in text and low-resolution modes, this sequence is the 1,024 
display-page addresses repeated eight times. The display address 
cycles through this sequence 60 times a second, or once every 17 
milliseconds. The way the low-order address lines are assigned to 
the RAMs, the row address cycles through all 256 possible values 
once every two milliseconds. (See Figure 7-11.) This more than 
satisfies the refresh requirements of the dynamic RAMs. 


Dynamic-RAM timing 


The Apple Ile’s microprocessor clock runs at a moderate speed, 
about 1.023 MHz, but the interleaving of CPU and display cycles 
means that the RAM is being accessed at a 2 MHz rate, or a cycle 
time of just under 500 nanoseconds. Data for the CPU is strobed by 
the falling edge of @0, and display data is strobed by the falling edge 
of @1, as shown in Figure 7-11. 


The RAM timing looks complicated because the RAM address is 
multiplexed, as described in the previous section. The MMU takes 
care of multiplexing the address for the CPU cycle, and the IOU 
performs the same function for the display cycle. The multiplexed 
address is sent to the RAM ICs over the lines labeled RAO-RA7. 
Along with the other timing signals, the PAL device generates two 
signals that control the RAM addressing: row-address strobe (RAS) 
and column-address strobe (CAS). 
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Figure 7-11 
RAM timing signals 
Table 7-10 
RAM timing signal descriptions 
Signal Description 
20 Clock phase 0 (CPU phase) 
@1 Clock phase 1 (display phase) 
RAS Row-address strobe 
CAS Column-address strobe 
Q3 Alternate RAM/column-address strobe 
RAO-RA7 Multiplexed address bus 
MDO-MD7 Internal data bus 
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The video display 


The Apple Ie produces a video signal that creates a display on a 
standard video monitor or, if you add an RF modulator, on a black- 
and-white or color television set. The video signal is a composite 
made up of the data that is being displayed plus the horizontal and 
vertical synchronization signals that the video monitor uses to 
arrange the lines of display data on the screen. 


“+ Video standards: Apple Ie’s manufactured for sale in the U.S. 
generate a video signal that is compatible with the standards set 
by the NTSC (National Television Standards Committee). 
Apple Ile’s manufactured for sale in European countries 
generate video that is a modified NTSC signal. 


The display portion of the video signal is a time-varying voltage 
generated from a stream of data bits, where a 1 corresponds to a 
voltage that generates a bright dot, and a 0 to a dark dot. The 
display bit stream is generated in bursts that correspond to the 
horizontal lines of dots on the video screen. The signal named 
WNDW’ is low during these bursts. 


During the time intervals between bursts of data, nothing is 
displayed on the screen. During these intervals, called the 
blanking intervals, the display is blank and the WNDW’ signal is 
high. The synchronization signals, called sync for short, are 
produced by making the signal named SYNC’ low during portions of 
the blanking intervals. The sync pulses are at a voltage equivalent to 
blacker-than-black video and don’t show on the screen. 


The video counters 


The address and timing signals that control the generation of the 
video display are all derived from a chain of counters inside the 
IOU. Only a few of these counter signals are accessible from outside 
the IOU, but they are all important in understanding the operation 
of the display generation process, particularly the display-memory 
addressing described in the next section. 
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The horizontal counter is made up of seven stages: HO, H1, H2, H3, 
H4, H5, and HPE’. The input to the horizontal counter is the 1 MHz 
signal that controls the reading of data being displayed. The 
complete cycle of the horizontal counter consists of 65 states. The 
six bits HO through H5 count normally from 0 to 63, then start over 
at 0. Whenever this happens, HPE’ forces another count with HO 
through HS held at 0, thus extending the total count to 65. 


The IOU uses the 40 horizontal count values from 25 through 64 in 
generating the low-order part of the display data address, as 
described later in this chapter in the section “Display Address 
Mapping.” The IOU uses the count values from 0 to 24 to generate 
the horizontal blanking, the horizontal sync pulse, and the color- 
burst gate. 


When the horizontal count gets to 65, it signals the end of a line by 
triggering the vertical counter. The vertical counter has nine stages: 
VA, VB, VC, VO, V1, V2, V3, V4, and V5. When the vertical count 
reaches 262, the IOU resets it and starts counting again from zero. 
Only the first 192 scanning lines are actually displayed, the IOU uses 
the vertical counts from 192 to 261 to generate the vertical blanking 
and sync pulse. Nothing is displayed during the vertical blanking 
interval. (The vertical line count is 262 rather than the standard 
262.5 because, unlike normal television, the Apple Ile’s video 
display is not interlaced.) 


“ Smooth animation: Animation displays sometimes have an 
erratic flicker caused by changing the display data at the same 
time it is being displayed. You can avoid this on the Apple Ile 
by reading the vertical-blanking signal (VBL) at location $C019 
and changing display data while VBL is low only (data value less 
than 128). 


Display memory addressing 


As described in Chapter 2 in the section “Addressing Display Pages 
Directly,” data bytes are not stored in memory in the same 
sequence in which they appear on the display. You can get an idea 
of the way the display data is stored by using the Monitor to set the 
display to graphics mode, then storing data starting at the 
beginning of the display page at hexadecimal $400 and watching the 
effect on the display. If you do this, you should use the graphics 
display instead of text to avoid confusion: the text display is also 
used for Monitor input and output. 
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The requirements of the RAM 
refreshing are discussed earlier in 
this chapter in the section 
“Dynamic-RAM Refreshment.” 


If you want your program to display data by storing it directly into 
the display memory, you must first transform the display 
coordinates into the appropriate memory addresses, as shown in 
the section “Video Display Pages” in Chapter 2. The descriptions 
that follow will help you understand how this address 
transformation is done and why it is necessary. They will not (alas!) 
eliminate that necessity. 


The address transformation that folds three rows of forty display 
bytes into 128 contiguous memory locations is the same for all 
display modes, so it is described first. The differences among the 
different display modes are then described in the section “Video 
Display Modes.” 


Display address mapping 


Consider the simplest display on the Apple Ile, the 40-column text 
mode. To address 40 columns requires 6 bits, and to address 24 
rows requires another 5 bits, for a total of 11 address bits. 
Addressing the display this way would involve 2048 (2 to the 
eleventh power) bytes of memory to display a mere 960 characters. 
The 80-column text mode would require 4096 bytes to display 1920 
characters. The leftover chunks of memory that were not displayed 
could be used for storing other data, but not easily, because they 
would not be contiguous. 


Instead of using the horizontal and vertical counts to address 
memory directly, the circuitry inside the IOU transforms them into 
the new address signals described below. The transformed display 
address must meet the following criteria: 


O map the 960 bytes of 40-column text into only 1024 bytes 

O scan the low-order address to refresh the dynamic RAMs 

0 continue to refresh the RAMs during video blanking 

The transformation involves only horizontal counts H3, H4, and 
H5, and vertical counts V3 and V4. Vertical count bits VA, VB, and 
VC address the lines making up the characters, and are not involved 
in the address transformation. The remaining low-order count bits, 


HO, H1, H2, VO, V1, and V2 are used directly, and are not involved 
in the transformation. 
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The IOU performs an addition that reduces the five significant count 
bits to four new signals called SO, $1, $2, and $3, where S stands for 
sum. Figure 7-12 is a diagram showing the addition in binary form, 
with V3 appearing as the carry in and H5 appearing as its 
complement HS’. A constant value of 1 appears as the low-order bit 
of the addend. The carry bit generated with the sum is not used. 


If this transformation seems obscure, try it with actual values. For 
example, for the upper-left corner of the display, the vertical count 
is 0 and the horizontal count is 24: HO, H1, H2, and H5 are 0’s, and 
H3, and H4 are 1’s. The value of the sum is 0, so the memory 
location for the first character on the display is the first location in 
the display page, as you might expect. 


Horizontal bits HO, H1, and H2 and sum bits SO, $1, and $2 make up 
the transformed horizontal address (AO through A6 in Table 7-12). 
As the horizontal count increases from 24 to 63, the value of the sum 
(S3 $2 S1 SO) increases from 0 to 4 and the transformed address goes 
from 0 to 39, relative to the beginning of the display page. 


The low-order three bits of the vertical row counter are VO, V1, and 
V2. These bits control address bits A7, A8, and A9, as shown in 
Table 7-12, so that rows 0 through 7 start on 127-byte boundaries. 
When the vertical row counter reaches 8, then VO, V1, and V2 are 0 
again, and V3 changes to 1. If you do the addition in Table 7-11 with 
H equal to 24 (the horizontal count for the first column displayed) 
and V equal to 8, the sum is 5 and the horizontal address is 40: the 
first character in row 8 is stored in the memory location 40 bytes 
from the beginning of the display page. 


Figure 7-12 shows how groups of 3 40-character rows are stored in 
blocks of 120 contiguous bytes starting on 127-byte address” 
boundaries. This diagram is another way of describing the display 
mapping shown in Figure 2-6. Notice that the 3 rows in each block of 
120 bytes are not adjacent on the display. 
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Table 7-11 


Display address transformation 


V3 Carry in 
H3 Augend 
1 Addend 


H5’ V3 H4 
V4 H5’ V4 


$3 82 S1 SO Sum 


<—$——_————— 128 Bytes 





8 
—+—— 40) Bytes —>| a Bytes —e| «10 Byes —e| 
ytes 





Figure 7-12 

40-column text display memory (memory locations marked with 
an asterisk * are reserved for use by peripheral I/O firmware: 
refer to the section “Peripheral-Card RAM Space” in Chapter 6) 


Table 7-12 shows how the signals from the video counters are 
assigned to the address lines. HO, H1, and H2 are horizontal-count 
bits, and VO, V1, and V2 are vertical-count bits. SO, $1, $2 and $3 
are the folded address bits described above. Address bits marked 
with an asterisk (*) are different for different modes: see Table 7-13 
and the four subsections under “Video Display Modes.” 


Table 7-12 

Display memory addressing 

Memory Display Memory Display 
address address address address 
bit bit bit bit 

AO HO A8& V1 

Al Hl A9 V2 

A2 H2 A10 bd 

A3 SO All . 

A4 $1 A12 ‘ 

A5 $2 A13 . 

A6 $3 Al4 = 

A7 vo Al5 GND 


“ For these address bits, see text and 
Table 7-13. 
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Table 7-13 
Memory address bits for display modes 


Display modes 
Address Text and High resolution and 
bit low resolution double high resolution 
A10 S8O0STORE+PAGE2’ VA 
All 80STORE’.PAGE2 VB 
Al12 0 VC 
Al3 0 80STORE+PAGE2’ 
Al4 0 80STOREv’.PAGE2 


Note: Period (.) means logical AND; prime () means 
logical NOT. 


Video display modes 


The different display modes all use the address-mapping scheme 
described in the preceding section, but they use different-sized 
memory areas in different locations. The next four sections 
describe the addressing schemes and the methods of generating the 
actual video signals for the different display modes. 


Text displays 


The text and low-resolution graphics pages begin at memory 
locations $0400 and $0800. Table 7-13 shows how the display-mode 
signals control the address bits to produce these addresses. Address 
bits A10 and A11 are controlled by the settings of PG2 and 
8OSTORE, which are set by the display-page and 80-column-video 
soft switches. Address bits A12, A13, and A14 are set to 0. Notice 
that 8OSTORE active inhibits PG2: there is only one display page in 
80-column mode. 


The bit patterns used for generating the different characters are 
stored in a 32K ROM. The low-order six bits of each data byte reach 
the character generator ROM directly, via the video data bus 
VIDO-VIDS. The two high-order bits are modified by the IOU to 
select between the primary and alternate character sets and are sent 
to the character generator ROM on lines RAO and RA10. 
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The data for each row of characters are read eight times, once for 
each of the eight lines of dots making up the row of characters. The 
data bits are sent to the character generator ROM along with VA, 
VB, and VC, the low-order bits from the vertical counter. For each 
character being displayed, the character generator ROM puts out 
one of eight stored bit patterns selected by the three-bit number 
made up of VA, VB, and VC. 


The bit patterns from the character generator ROM are loaded into 
the 74166 parallel-to-serial shift register and output as a serial bit 
stream that goes to the video output circuit. The shift register is 
controlled by signals named LDPS’ (for load parallel-to-serial 
shifter) and VID7M (for video 7 MHz). In 40-column mode, LDPS’ 
strobes the output of the character generator ROM into the shift 
register once each microsecond, and bits are sent to the screen at a 
7 MHz rate. 


The addressing for the 80-column display is exactly the same as for 
the 40-column display: the 40 columns of display memory on the 
80-column card are addressed in parallel with the 40 columns in 
main memory. The data from these two memories reach the video 
data bus (lines VIDO-VID7) via separate 74LS374 three-state buffers. 
These buffers are loaded simultaneously, but their outputs are sent 
to the character generator ROM alternately by @0 and @1. In 80- 
column mode, LDPS’ loads data from the character generator ROM 
into the shift register twice during each microsecond, once during 
@0 and once during @1, and. bits are sent to the screen at a 14 MHz 
rate. Figures 7-13a and 7-13b show the video timing signals. 
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14 MHz video timing signals 


Low-resolution display 


In the graphics modes, VA and VB are not used by the character 
generator, so the IOU uses lines SEGA and SEGB to transmit HO and 
HIRES’ , as shown in Table 7-14. 


Table 7-14 
Character-generator control signals 


Display mode SEGA  SEGB SEGC 


Text VA VB VC 
Graphics HO HIRES’ VC 
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The low-resolution graphics display uses VC to divide the eight 
display lines corresponding to a row of characters into two groups 
of four lines each. Each row of data bytes is addressed eight times, 
the same as in text mode, but each byte is interpreted as two 
nibbles. Each nibble selects one of 16 colors. During the upper four 
of the eight display lines, VC is low and the low-order nibble 
determines the color. During the lower four display lines, VC is 
high and the high-order nibble determines the color. 


The bit patterns that produce the low-resolution colors are read 
from the character-generator ROM in the same way the bit patterns 
for characters are produced in text mode. The 74166 parallel-to- 
serial shift register converts the bit patterns to a serial bit stream for 
the video circuits. 


The video signal generated by the Apple Ile includes a short burst of 
3.58 MHz signal that is used by an NISC color monitor or color TV 
set to generate a reference 3.58 MHz color signal. The Apple Ile’s 
video signal produces color by interacting with this 3.58 MHz signal 
inside the monitor or TV set. Different bit patterns produce 
different colors by changing the duty cycles and delays of the bit 
stream relative to the 3.58 MHz color signal. To produce the small 
delays required for so many different colors, the shift register runs 
at 14 MHz and shifts out 14 bits during each cycle of the 1 MHz data 
clock. To generate a stream of fourteen bits from each eight-bit 
pattern read from the ROM, the output of the shift register is 
connected back to the register’s serial input to repeat the same eight 
bits; the last two bits are ignored the second time around. 


Each bit pattern is output for the same amount of time as a 
character: 0.98 microseconds. Because that is exactly enough time 
for three and a half cycles of the 3.58 MHz color signal, the phase 
relationship between the bit patterns and the signal changes by a 
half cycle for each successive pattern. To compensate for this, the 
character generator ROM puts out one of two different bit patterns 
for each nibble, depending on the state of HO, the low-order bit of 
the horizontal counter. 
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High-resolution display 


The high-resolution graphics pages begin at memory locations 
$2000 and $4000 (decimal 8192 and 16384). These page addresses 
are selected by address bits A13 and A14. In high-resolution mode, 
these address bits are controlled by PG2 and 80STORE, the signals 
controlled by the display-page (PAGE2) and 80-column-video 
(80COL) soft switches. As in text mode, 80STORE inhibits 
addressing of the second page because there is only one page of 80- 
column text available for mixed mode. 


In high-resolution graphics mode, the display data are still stored 
in blocks like the one shown in Figure 7-12, but there are eight of 
these blocks. As Tables 7-12 and 7-13 show, vertical counts VA, VB, 
and VC are used for address bits A10, Al1, and A12, which address 
eight blocks of 1024 bytes each. Remember that in the display, VA, 
VB, and VC count adjacent horizontal lines in groups of eight. This 
addressing scheme maps each of those lines into a different 1024- 
byte block. It might help to think of it as a kind of eight-way 
multiplexer: it’s as if eight text displays were combined to produce a 
single high-resolution display, with each text display providing one 
line of dots in turn, instead of a row of characters. 


The high-resolution bit patterns are produced by the character- 
generator ROM. In this mode, the bit patterns simply reproduce the 
eight bits of display data. The low-order six bits of data reach the 
ROM via the video data bus VIDO-VID5. The IOU sends the other 
two data bits to the ROM via RA9 and RA10. 


The high-resolution colors described in Chapter 2 are produced by 
the interaction between the video signal the bit patterns generate 
and the 3.58 MHz color signal generated inside the monitor or TV 
set. The high-resolution bit patterns are always shifted out at 7 MHz, 
so each dot corresponds to a half-cycle of the 3.58 MHz color 
signal. Any part of the video signal that produces a single white dot 
between two black dots, or vice versa, is effectively a short burst of 
3.58 MHz and is therefore displayed as color. In other words, a bit 
pattern consisting of alternating 1’s and 0’s gets displayed as a line 
of color. The high-resolution graphics subroutines produce the 
appropriate bit patterns by masking the data bits with alternating 1’s 
and 0’s. 
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To produce different colors, the bit patterns must have different 
phase relationships to the 3.58 MHz color signal. If alternating 1’s 
and 0’s produce a certain color, say green, then reversing the 
pattern to 0’s and 1’s will produce the complementary color, 
purple. As in the low-resolution mode, each bit pattern 
corresponds to three and a half cycles of the color signal, so the 
phase relationship between the data bits and the color signal 
changes by a half cycle for each successive byte of data. Here, 
however, the bit patterns produced by the hardware are the same 
for adjacent bytes; the color compensation is performed by the 
high-resolution software, which uses different color masks for data 
being displayed in even and odd columns. 


To produce other colors, bit patterns must have other timing 
relationships to the 3.58 MHz color signal. In high-resolution 
mode, the Apple Ile produces two more colors by delaying the 
output of the shift register by half a dot (70 ns), depending on the 
high-order bit of the data byte being displayed. (The high-order bit 
doesn’t actually get displayed as a dot, because at 7 MHz there is 
only time to shift out seven of the eight bits.) 


As each byte of data is sent from the character generator to the shift 
register, high-order data bit D7 is also sent to the PAL device. If D7 
is off, the PAL device transmits shift-register timing signals LDPS’ 
and VID7M normally. If D7 is on, the PAL device delays LDPS’ and 
VID7M by 70 nanoseconds, the time corresponding to half a dot. 
The bit pattern that formerly produced green now produces orange; 
the pattern for purple now produces blue. 


“ A note about timing: For 80-column text, the shift register is 
clocked at twice normal speed. When 80-column text is used 
with graphics in mixed mode, the PAL device controls shift- 
register timing signals LDPS’ and VID7M so that the graphics 
portion of the display works correctly even when the text 
window is in 80-column mode. 


Double high-resolution display 


Double high-resolution graphics mode displays two bytes in the 
time normally required for one, but uses high-resolution graphics 
Page 1 in both main and auxiliary memory instead of text or low- 
resolution Page 1. 


“ Note: There is a second pair of pages, high-resolution Page 2, 
which can be used to display a second double high-resolution 
page. 
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Double high-resolution graphics mode displays each pair of data 
bytes as 14 adjacent dots, seven from each byte. The high-order bit 
(color-select bit) of each byte is ignored. The auxiliary-memory 
byte is displayed first, so data from auxiliary memory appears in 
columns 0-6, 14-20, and so on, up to columns 547-552. Data from 
main memory appears in columns 7-13, 21-27, and so on, up to 
553-559. 


As in 80-column text, there are twice as many dots across the 
display screen, so the dots are only half as wide. On a TV set or low- 
bandwidth monitor (less than 14 MHz), single dots will be dimmer 
than normal. 


“ Note: Except for some expensive RGB-type monitors, any 
video monitor with a bandwidth as high as 14 MHz will be a 
monochrome monitor. Monochrome means one color: a 
monochrome video monitor can have a screen color of white, 
green, orange, or any other single color. 


The main memory and auxiliary memory are connected to the 
address bus in parallel, so both are activated during the display 
cycle. The rising edge of @0 clocks a byte of main memory data into 
the video latch, and a byte of auxiliary memory data into the 80 
latch. 


g1 enables output from the (auxiliary) 80 latch, and @0 enables 
output from the (main) video latch. Output from both latches goes 
to CHARGEN, where GR and SEGB’ select high-resolution graphics. 
LDPS operates at 2 MHz in this mode, alternately gating the 
auxiliary byte and main byte into the parallel-to-serial shift register. 
VID7M is active (kept true) for double high-resolution display 
mode, so when it is ANDed with 14M, the result is still 14M. The 
14M serial clock signal gate shift register then outputs to VID, the 
video display hybrid circuit, for output to the display device. 


Video outpuf signals 


The stream of video data generated by the display circuits described 
above goes to a linear summing circuit built around transistor Q1 
where it is mixed with the sync signals and the color burst. Resistors 
R3, R5, R7, R10, R13, and R15 adjust the signals to the proper 
amplitudes, and a tank circuit (L3 and C32) resonant at 3.58 MHz 
conditions the color burst. 
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The resulting video signal is an NTSC-compatible composite-video 
signal that can be displayed on a standard video monitor. The 
signal is similar to the EIA (Electronic Industries Association) 
standard positive composite video (see Table 7-15). This signal is 
available in two places in the Apple Ile: 


O At the phono jack on the back of the Apple Ile. The sleeve of this 
jack is connected to ground and the tip is connected to the video 
output through a resistor network that attenuates it to about 1 volt 
and matches its impedance to 75 ohms. 


O At the internal video connector on the Apple Ile circuit board 
near the RCA jack, J13 in Figure 7-15c. It is made up of four 
Molex-type pins, 0.25 inches tall, on 0.10-inch centers. This 
connector carries the video signal, ground, and two power 
supplies, as shown in Table 7-15. 


Table 7-15 
Internal video connector signals 


Pin Signal Description 


1 GROUND System common ground. 


2 VIDEO NTSC-compatible positive composite video. 
White level is about 2.0 volts, black level is 
about 0.75 volts, and sync level is 0.0 volts. 
This output is not protected against short- 


circuits. 
3 -5V —5 volt power supply. 
4 +12V +12 volt power supply. 


Built-in 1/O circuits 


The use of the Apple Ile’s built-in I/O features is described in 
Chapter 2. This section describes the hardware implementation of 
all of those features except the video display described in the 
previous sections. 


The IOU Cnput/Output Unit) directly generates the output signals 
for the speaker, the cassette interface, and the annunciators. The 
other I/O features are handled by smaller ICs, as described later in 
this section. 
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The addresses of the built-in I/O features are described in Chapter 2 
and listed in Tables 2-1, 2-10, and 2-11. All of the built-in I/O 
features except the displays use memory locations between $C000 
and $C070 (decimal 49152 and 49264). The I/O address decoding is 
performed by three ICs: a 7418138, a 74LS154, and a 7418251. 


The 74LS138 decodes address lines A8, A9, A10, and A11 to select 
address pages on 256-byte boundaries starting at $C000 (decimal 
49152). When it detects addresses between $C000 and $COFF, it 
enables the IOU and the 7418154. The 74LS154 in turn decodes 
address lines A4, AS, AG, and A7 to select 16-byte address areas 
between $C000 and $COFF. Addresses between $C060 and $CO6F 
enable the 74LS251 that multiplexes the hand control switches and 
paddles; addresses between $C070 and $CO7F reset the NE558 
quadruple timer that interfaces to the hand controls, as described 
later in the section “Game I/O Signals.” 


The keyboard 


The Apple Ile’s keyboard is a matrix of keyswitches connected to an 
AY-3600-type keyboard decoder via a ribbon cable and a 26-pin 
connector. The AY-3600 scans the array of keys over and over to 
detect any keys pressed. The scanning rate is set by the external 
resistor-capacitor network made up of C70 and R32. The debounce 
time is also set externally, by C71. 


The AY-3600’s outputs include five bits of key code plus separate 
lines for Control, Shift, any-key-down, and keyboard strobe. The 
any-key-down and keyboard-strobe lines are connected to the IOU, 
which addresses them as soft switches. The key-code lines, along 
with Control and Shift, are inputs to a separate 2316 ROM. The ROM 
translates them to the character codes that are enabled onto the 
data bus by signals named KBD’ and ENKBD’ . The KBD’ signal is 
enabled by the MMU whenever a program reads location $C000, as 
described in the section “Reading the Keyboard” in Chapter 2. 


Table 7-16 

Keyboard connector signals 

Pin Signal Description 

1,2,4,6,8,10, YO-Y9 Y-direction key-matrix connections 
23,25,12,22 

3 +5 +5 volt supply 

5,7,9,15 n.c. 

11 LCNTL’ Line from Control key 
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Extended keyboard Ile 


Table 7-16 (continued) 
Keyboard connector signals 


Pin Signal Description 

13 GND System common ground 

14,18, 16,20, X0-X7 X-direction key-matrix connections 
21,19,26,17 

24 LSHFT’ Line from Shift key 


Connecting a keypad 


There is a smaller connector wired in parallel with the keyboard 
connector in the original and the enhanced Ile. You can connect a 
ten-key numeric pad to the Apple Ile via this connector. 


The extended keyboard Ile has a numeric keypad built into the 


keyboard. 

Table 7-17 

Keypad connector signals 

Pin Signal Description 

1,2,5,3,4,6 Y0O-Y5 Y-direction key-matrix connections 
zy n.c. 

9,11,10,8 X4-X7 X-direction key-matrix connections 


Cassette I/O 


The two miniature phone jacks on the back of the Apple Ile are used 
to connect an audio cassette recorder for saving programs. The 
output signal to the cassette recorder comes from a pin on the IOU 
via resistor network R6 and R9, which attenuates the signal to a level 
appropriate for the recorder’s microphone input. Input from the 
recorder is amplified and conditioned by a type 741 operational 
amplifier and sent to one of the inputs of the 74LS251 input 
multiplexer. 


The signal specifications for cassette I/O are 


O Input: 1 volt (nominal) from recorder earphone or monitor 
output. Input impedance is 12K ohms. 


O Output: 25 millivolts to recorder microphone input. Output 
impedance is 100 ohms. 
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Table 7-18 


Speaker connector signals 


Pin Signal 
1 SPKR 
2 +5 


Description 


Speaker signal. 
This line will 
deliver about 
0.5 watt into an 
8-ohm speaker. 


+5V power 
supply. Note 
that the speaker 
is not connected 


to system ground. 


The speaker 


The Apple Ile’s built-in loudspeaker is controlled by a single bit of 
output from the IOU (input Output Unit). The signal from the IOU is 
AC coupled to Q5, an MPSA13 Darlington transistor amplifier. The 
speaker connector is a Molex KK100 connector, J18 in Figure 7-15b, 
with two square pins 0.25 inches tall and on 0.10-inch centers. 


A light-emitting diode is connected in parallel across the speaker 
pins such that, when the speaker is not connected, the diode glows 
whenever the speaker signal is on. This diode is used as a diagnostic 
indicator during assembly and testing of the Apple Ile. 


Game I/O signals 


Several I/O signals that are individually controlled via soft switches 
are collectively referred to as the game signals. Even though they 
are normally used for hand controls, these signals can be used for 
other simple I/O applications, There are five output signals: the 
four annunciators, numbered AO through A3, and one strobe 
output. There are three one-bit inputs, called switches and 
numbered SW0 through SW2, and four analog inputs, called 
paddles and numbered PDLO through PDL3. 


The annunciator outputs are driven directly by the IOU (Input 
Output Unit). These outputs can drive one TTL (transistor- 
transistor logic) load each; for heavier loads, you must use a 
transistor or a TTL buffer on these outputs. These signals are only 
available on the 16-pin internal connector. (See Table 7-19.) 


The strobe output is a pulse transmitted any time a program reads or 
writes to location $C040. The strobe pin is connected to one output 
of the 74LS154 address decoder. This TTL signal is normally high; it 
goes low during @0 of the instruction cycle that addresses location 
$C040. This signal is only available on the 16-pin internal 
connector. (See Table 7-19.) 


The game inputs are multiplexed along with the cassette input signal 
by a 7418251 eight-input multiplexer enabled by the C06X’ signal 
from the 74LS154 I/O address decoder. Depending on the low- 
order address, the appropriate game input is connected to bit 7 of 
the data bus. 
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The switch inputs are standard low-power Schottky TTL inputs. To 
use them, connect each one to 560-ohm pull-down resistors 
connected to the ground and through single-pole, momentary- 
contact pushbutton switches to the +5 volt supply. 


The hand-control inputs are connected to the timing inputs of an 
NE558 quadruple 555-type analog timer. Addressing $CO7X sends a 
signal from the 74LS154 that resets all four timers and causes their 
outputs to go to 1 (high). A variable resistance of up to 150K ohms 
connected between one of these inputs and the +5V supply controls 
the charging time of one of four 0.022-microfarad capacitors. 
When the voltage on the capacitor passes a certain threshold, the 
output of the NE558 changes back to 0 dow). Programs can 
determine the setting of a variable resistor by resetting the timers 
and then counting time until the selected timer-input changes from 
high to low. The resulting count is proportional to the resistance. 


The game I/O signals are all available on a 16-pin DIP socket 
labeled GAME I/O on the main circuit board inside the case. The 
switches and the paddles are also available on a D-type miniature 
connector on the back of the Apple Ile; see J8 and J15 in 

Figure 7-15d (Figure 7-16d for the extended keyboard IIe). 


Table 7-19 

Game |/O connector signals 

Internal Back-panel 

connector connector 

pin pin Signal Description 

1 2 +5V +5V power supply. Total 
current drain from this 
pin must not exceed 
100mA. 

2,3,4 7,1,6 PBO-PB2 Switch inputs. These are 
standard 74LS inputs. 

5 _ STROBE’ Strobe output. This line 
goes low during go of a 
read or write instruction 
to location $C040. 

6,10, 5,8,4,9 PDLO-PDL3 Hand control inputs. 

7,11 Each of these should 


be connected to a 
150K-ohm variable 
resistor connected to 
+5V. 
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Chapter 6 describes the 
standards for programming 


peripheral cards for the Apple lle. 


Table 7-19 (continued) 
Game |/O connector signals 


Internal Back-panel 

connector connector 

pin pin Signal Description 

8 3 GND System ground. 

15,14, — ANO-AN3 Annunciators. These are 

13,12 standard 74LS TTL 
outputs and must be 
buffered to drive other 
than TTL inputs. 

9,16 —_ n.c. Nothing is connected to 


these pins. 


Expanding the Apple Ile 


The main circuit board of the Apple Ile has eight empty card 
connectors or slots on it. These slots make it possible to add 
features to the Apple Ile by plugging in peripheral cards with 
additional hardware. This section describes the hardware that 
supports them, including all of the signals available on the 
expansion slots. 


The expansion slots 


The seven connectors lined up across the back part of the 

Apple Ile’s main circuit card are the expansion slots, also called 
peripheral slots or simply slots, numbered from 1 to 7. They are 50- 
pin PC-card edge connectors with pins on 0.10-inch centers. A PC 
card plugged into one of these connectors has access to all of the 
signals necessary to perform input and output and to execute 
programs in RAM or ROM on the card. These signals are described 
briefly in Table 7-20. The following paragraphs describe the signals 
in general and mention a few points that are often overlooked. For 
further details, refer to the schematic diagram in Figures 7-15a—d 
(Figure 7-16a—-d for the extended keyboard IIe). 
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The peripheral address bus 


The microprocessor’s address bus is buffered by two 74LS244 octal 
three-state buffers. These buffers, along with a buffer in the 
microprocessor’s R/W’ line, are enabled by a signal derived from 
the DMA’ daisy chain on the expansion slots. Pulling the peripheral 
line DMA’ low disables the address and R/W’ buffers so that 
peripheral DMA circuitry can control the address bus. The DMA 
address and R/W’ signals supplied by a peripheral card must be 
stable all during @0 of the instruction cycle, as shown in 

Figure 7-14. 


Another signal that can be used to disable normal operation of the 
Apple Ie is INH’ . Pulling INH’ low disables all of the memory in the 
Apple Ile except the part in the I/O space from $C000 to $CFFF. A 
peripheral card that uses either INH’ or DMA’ must observe proper 
timing; in order to disable RAM and ROM cleanly, the disabling 
signal must be stable all during @0 of the instruction cycle (refer to 
the timing diagram in Figure 7-14). 


The peripheral devices should use I/O SELECT’ and DEVICE 
SELECT’ as enables. Most peripheral ICs require their enable 
signals to be present for a certain length of time before data is 
strobed into or out of the device. Remember that I/O SELECT’ and 
DEVICE SELECT’ are only asserted during @0 high. 


The peripheral data bus 


The Apple Ile has two versions of the microprocessor data bus: 

an internal bus, MDO-MD7, connected directly to the 
microprocessor; and an external bus, DO-D7, driven by a 74LS245 
octal bidirectional bus buffer. The 65C02 is fabricated with MOS 
circuitry, so it can drive capacitive loads of up to about 130 pF. If 
peripheral cards are installed in all seven slots, the loading on the 
data bus can be as high as 500 pF, so the 74LS245 drives the data bus 
for the peripheral cards. The same argument applies if you use MOS 
devices on peripheral cards: they don’t have enough drive for the 
fully loaded bus, so you should add buffers. 
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Loading and driving rules 


Table 7-20 shows the drive requirements and loading limits for each 
pin on the expansion slots. The address bus, the data bus, and the 
R/W’ line should be driven by three-state buffers. Remember that 
there is considerable distributed capacitance on these buses and 
that you should plan on tolerating the added load of up to six 
additional peripheral cards. MOS devices such as PIAs and ACIAs 
cannot switch such heavy capacitive loads. Connecting such 
devices directly to the bus will lead to possible timing and level 
errors. 


Interrupt and DMA daisy chains 


The interrupt requests (IRQ’ and NMI’) and the direct-memory 
access (DMA’) signal are available at all seven expansion slots. A 
peripheral card requests an interrupt or a DMA transfer by pulling 
the appropriate output line low (active). If two peripheral cards 
request an interrupt or a DMA transfer at the same time, they will 
contend for the data and address busses. To prevent this, two pairs 
of pins on each connector are wired as a priority daisy chain. The 
daisy-chain pins for interrupts are INT IN and INT OUT, and the 
pins for DMA are DMA IN and DMA OUT, as shown for J1-J7 in 
Figure 7-15d (Figure 7-16d for the extended keyboard Ile). 


Each daisy chain works like this: the output from each connector 
goes to the input of the next higher numbered one. For these signals 
to be useful for cards in lower numbered connectors, all of the 
higher numbered connectors must have cards in them, and all of 
those cards must connect DMA IN to DMA OUT and INT IN to INT 
OUT. Whenever a peripheral card uses pin DMA’, it must do so 
only if its DMA IN line is active, and it must disable its DMA OUT 
line while it is using DMA’. The INT IN and INT OUT lines must be 
used the same way: enable the card’s interrupt circuits with INT IN, 
and disable INT OUT whenever IRQ’ or NMI’ is being used. 
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sas CPU Phase 


$1 j Video Phase | j 


Address 
oe Be 
INH’, DMA’ 


Peripheral Select 


1/0 SELECT’ 
DEVICE SELECT 


1/0 STROBE’ 


Figure 7-14 
Peripheral-signal timing 


Table 7-20 
Expansion slot signals 


Pin Signal 


1 1/O SELECT 
2-17 A0-A15 


18 R/W’ 
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| |—140 ns (Max.) 30 ns sea | 


Description 


Normally high; goes low during a0 when 
the 65C02 addresses location $CnXX, 
where n is the connector number. This 
line can drive 10 LS TTL loads.* 


Three-state address bus. The address 
becomes valid during @1 and remains 
valid during @0. Each address line can 
drive 5 LS TIL loads.* 


Three-state read/write line. Valid at the 
same time as the address bus; high 
during a read cycle, low during a write 
cycle. It can drive 2 LS TTL loads.* 


Table 7-20 (continued) 
Expansion slot signals 


Pin Signal Description 


19 SYNC’ Composite horizontal and vertical 
sync,on expansion slot 7 only. This line 
can drive 2 LS TTL loads.* 


20 I/O STROBE’ Normally high; goes low during 0 when 
the 65C02 addresses a location between 
$C800 and $CFFF. This line can drive 
4 LS TTL loads. 


21 RDY Input to the 65C02. Pulling this line low 
during @1 halts the 65C02 with the 
address bus holding the address of the 
location currently being fetched. This 
line has a 3300 ohm pullup resistor to 
+5V. 


22 DMA’ Input to the address bus buffers. Pulling 
this line low during @1 disconnects the 
65C02 from the address bus. This line 
has a 3300 ohm pullup resistor to +5V. 


23 INT OUT Interrupt priority daisy-chain output. 
Usually connected to pin 28 (INT IN).+ 

24 DMA OUT DMA priority daisy-chain output. 
Usually connected to pin 22 (DMA IN). 

25 +5V +5-volt power supply. A total of 500mA 
is available for all peripheral cards. 

26 GND System common ground. 

27 DMA IN DMA priority daisy-chain input. Usually 
connected to pin 24 (DMA OUT). 

28 INT IN Interrupt priority daisy-chain input. 
Usually connected to pin 23 (NT OUT). 

29 NMI’ Nonmaskable interrupt to 65C02. 


Pulling this line low starts an interrupt 
cycle with the interrupt-handling 
routine at location $03FB. This line has 
a 3300 ohm pullup resistor to +5V. 
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Table 7-20 (continued) 
Expansion slot signals 


Pin Signal Description 


30 IRQ’ Interrupt request to 65C02. Pulling this 
line low starts an interrupt cycle only if 
the interrupt-disable (D flag in the 
65C02 is not set. Uses the interrupt- 
handling routine at location $03FE. This 
line has a 3300 ohm pullup resistor to 


+5V. 
31 RES’ Pulling this line low initiates a reset 
routine, as described in Chapter 4. 
32 INH’ Pulling this line low during @1 inhibits 


(disables) the memory on the main 
circuit board. This line has a 3300 ohm 
pullup resistor to +5V. 


33 -12V -12 volt power supply. A total of 200mA 
is available for all peripheral cards. 

34 -5V -5 volt power supply. A total of 200mA is 
available for all peripheral cards. 

55 3.58M 3.58 MHz color reference signal, on slot 
7 only. This line can drive 2 LS TTL 
loads.* 

36 7M System 7 MHz clock. This line can drive 
2 LS TIL loads.* 

37 Q3 System 2 MHz asymmetrical clock. This 
line can drive 2 LS TTL loads.* 

38 @1 65C02 phase 1 clock. This line can drive 
2 LS TTL loads.* 

39 pL PSYNC The 65C02 signals an operand fetch by 


driving this line high during the first 
read cycle of each instruction. 


40 20 65C02 phase 0 clock. This line can drive 
2 LS TIL loads.* 
41 DEVICE Normally high; goes low during @0 when 
SELECT’ the 65C02 addresses location $COnxX, 


where n is the connector number plus 8. 
This line can drive 10 LS TTL loads.* 
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Important 


Table 7-20 (continued) 
Expansion slot signals 


Pin Signal Description 


42-49 DO0-D7 Three-state buffered bi-directional data 
bus. Data becomes valid during @0 high 
and remains valid until @0 goes low. 
Each data line can drive one LS TTL 
load.* 


50 +12V +12 volt power supply. A total of 250mA 
is available for all peripheral cards. 


* Loading limits are for each card. 
+ On slot 7 only, this pin can be connected to the graphics-mode signal 
GR: see text for details. 


The auxiliary slot 


The large connector at the left side of the Apple Ile’s main circuit 
card is the auxiliary slot. It is a 60-pin PC-card edge connector with 
pins on 0.10-inch centers. A PC card plugged into this connector 
has access to all of the signals used in producing the video display. 
These signals are described briefly in Table 7-21. For further 
details, refer to the schematic diagram in Figure 7-15a—d 

(Figure 7-16a—d for the extended keyboard Ile). 


Many of the internal signals that are not available on the expansion 
slots are on the auxiliary slot. By using both kinds of connectors, 
manufacturing and repair personnel can gain access to most of the 
signals needed for diagnosing problems in the Apple Ile. 


In the extended keyboard lle, the auxiliary slot Is already 
occupied by the Extended 80-Column Text Card. 


80-column display signals 


The additional memory needed for producing an 80-column text 
display is on the 80-column text card, along with the buffers that 
transfer the data to the video data bus, as described earlier in this 
chapter in the section “Text Displays.” The signals that control the 
80-column text data include the system clocks @0 and @1, the 
multiplexed RAM address RAO-RA7, the RAM address-strobe 
signals PRAS’ and PCAS’, and the auxiliary-RAM enable signals, 
EN80’ and R/W80. 
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The EN80’ enable signal is controlled by the 80STORE soft switch 
described in Chapter 4. Data is sent to the auxiliary memory via the 
internal data bus MDO-—MD7; the data is transferred to the video 
generator via the video data bus VIDO-VID7. 


Table 7-21 

Auxiliary slot signals 
Pin Signal 

1 3.58M 
2 VID7M 
3 SYNC’ 
4 PRAS’ 
5 vc 

6 CO7x’ 
7 WNDW’ 
8 SEGA 


51,10,49, RAO-RA7 


48,13,14, 

46,9 

11,12 ROMEN1, 
ROMEN2 

44,43,40, | MDO-MD7 

39,21,20, 

17,16 


198 Chapter 7: Hardware Implementation 


Description 


3.58 MHz video color reference 
signal. This line can drive two LS TIL 
loads. 


Clocks the video dots out of the 74166 
parallel-to-serial shift register. This 
line can drive two LS TTL loads. 


Video horizontal and vertical sync 
signal. This line can drive two LS TIL 
loads. 


Multiplexed RAM row-address 
strobe. This line can drive two LS TTL 
loads. 


Third low-order vertical-counter bit. 
This line can drive two LS TTL loads. 


Hand-control reset signal. This line 
can drive two LS TIL loads. 


Video nonblank window. This line 
can drive two LS TTL loads. 


First low-order vertical counter bit. 
This line can drive two LS TTL loads. 


Multiplexed RAM-address bus. This 
line can drive two LS TTL loads. 


Enable signals for the ROMs on main 
circuit board. 


Internal (unbuffered) data bus. This 
line can drive two LS TTL loads. 


Table 7-21 (continued) 
Auxiliary slot signals 


Pin 
45,42,41, 
38,22,19, 
18,15 

23 

24 

25 

26 

27 


28 


29 


30 
31 
32 


33 


34 


Signal 


VIDO-VID7 


20 


CLRGAT’ 


80VID’ 


EN80’ 


ALTVID’ 


SEROUT’ 


ENVID’ 


+5 
GND 
14M 


PCAS’ 


LDPS’ 


Description 


Video data bus. This three-state bus 
carries video data to the character 
generator. 


65C02 clock phase 0. This line can 
drive two LS TTL loads. 


Color-burst gating signal. This line 
can drive two LS TTL loads. 


Enables 80-column display timing. 
This line can drive two LS TTL loads. 


Enable for auxiliary RAM. This line 
can drive two LS TTL loads. 


Alternative video output to the video 
summing amplifier. 


Video serial output from 74166 
parallel-to-serial shift register. 


Normally low; driving this line high 
disables the character generator such 
that the video dots from the shift 
register are all high (white), and 
alternative video can be sent out via 
ALTVID. This line has a 1000 ohm 
pulldown resistor to ground. 


+5 volt power supply. 
System common ground. 


14.3 MHz master clock signal. This 
line can drive two LS TTL loads. 


Multiplexed column-address strobe. 
This line can drive two LS TTL loads. 


Strobe to video parallel-to-serial shift 
register. This signal goes low to load 
the contents of the video data bus 
into the shift register. This line can 
drive two LS TTL loads. 


Expanding the Apple lle 199 


Table 7-21 (continued) 
Auxiliary slot signals 


Pin 


35 


36 


37 


47 


50 


52 


53 


54 


55 


56,57 


58 


59 


60 


Signal 


R/W80 


@1 


CASEN’ 


HO 


AN3 


Q3 


SEGB 


FRCTXT’ 


RA9’,RA10’ 


GR 


7M 


ENTMG’ 
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Description 


Read/write signal for RAM on the 
card in this slot. This line can drive 
two LS TIL loads. 


65C02 clock phase 1. This line can 
drive two LS TTL loads. 


Column-address enable. This signal 
is disabled (held high) during 
accesses to memory on the card in 
this slot. This line can drive two 

LS TIL loads. 


Low-order horizontal byte 
counter.This line can drive two LS 
TIL loads. 


Output of annunciator number 3.This 
line can drive two LS TTL loads. 


65C02 read/write signal. This line can 
drive two LS TTL loads. 


2 MHz asymmetrical clock. This line 
can drive two LS TTL loads. 


Second low-order vertical-counter 
bit. This line can drive two LS TTL 
loads. 


Normally high; pulling this line low 
enables 14MHz video output even 
when GR is active. 


Character-generator control signals 
from the IOU. This line can drive two 
LS TTL loads. 


Graphics-mode enable signal. This 
line can drive two LS TTL loads. 


7 MHz timing signal. This line can 
drive two LS TIL loads. 


Normally low, pulling this line high 
disables the master timing from the 
PAL device. This line has a 1000 ohm 
pulldown resistor to ground. 
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Figure 7-15c 
Original and enhanced Ile schematic diagram, part 3 
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Appendix A 


The 65C02 Microprocessor 


This appendix contains a description of the differences between the 
6502 and the 65C02 microprocessors. It also contains the data sheet 
for the 65C02 microprocessor. 


The 6502 microprocessor was used in the original Apple Ile, 

Apple II Plus, and Apple II. The 65C02 is a 6502 that uses less power 
and has ten new instructions and two new addressing modes. The 
65C02 is used in the enhanced and extended keyboard Apple IIe’s, 
as well as in the Apple IIc. 


In the data sheet tables, execution times are specified in number of 
cycles. One cycle time for the Apple Ile equals 0.978 
microseconds, giving a system clock rate of about 1.02 MHz. 


“ Note: If you want to write programs that execute on all 
computers in the Apple II series, use only those 65C02 
instructions that are also present on the 6502. 


Differences between 6502 and 65C02 


The data sheet lists the instructions and addressing modes of the 
65C02. This section supplements that information by listing those 
instructions whose execution times or results differ in the 6502 and 
the 65C02. 
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Different cycle times 


A few instructions on the 65C02 operate in different numbers of 
cycles than their 65C02 equivalents. These instructions are listed in 


Table A-1. 
Table A-1 
Cycle time differences 

6502 65C02 
Instruction/mode Opcode cycles cycles 
ASL Absolute, X 1E 7 6 
DEC Absolute, X DE 7 6 
INC Absolute, X FE 7 6 
JMP (Absolute) 6C 5 6 
LSR Absolute, X 5E 7 6 
ROL Absolute, X 3E 7 6 
ROR Absolute, X 7E 7 6 


Different instruction results 


It is important to note that the BIT instruction when used in 
immediate mode (opcode $89) leaves processor status register 
bits 7 (N) and 6 CV) unchanged on the 65C02. On the 6502, all 
modes of the BIT instruction have the same effect on the status 
register: the value of memory bit 7 is placed in status bit 7, and 
memory bit 6 is placed in status bit 6. 


Also note that if the JMP indirect instruction (code $6C) references 
an indirect address location that spans a page boundary, the 65C02 
fetches the high-order byte of the effective address from the first 
byte of the next page, while the 6502 fetches it from the first byte of 
the current page. For example, JMP ($02FF) gets ADL from location 
$02FF on both processors. But on the 65C02, ADH comes from 
$0300; on the 6502, ADH comes from $0200. 


Data sheet 


The remaining pages of this appendix are copyright 1982, 
NCR Corporation, Dayton, Ohio, and are reprinted with their 
permission. 
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= GENERAL DESCRIPTION | 


The NCR CMOS 6502 is an 8-bit microprocessor which is soft- 
ware compatible with the NMOS 6502. The NCR65C02 hardware 
interfaces with all 6500 peripherals. The enhancements include 
ten additional instructions, expanded operational codes and 
two new addressing modes. This microprocessor has all of the ad- 
vantages of CMOS technology: low power consumption, increased 
noise immunity and higher reliability. The CMOS 6502 is a low 
power high performance microprocessor with applications in the 
consumer, business, automotive and communications market. 


= FEATURES 


encompassing ten new instructions and two additional 
addressing modes. 





Enhanced software performance including 27 additional OP codes 











NCR65C02 


PIN CONFIGURATION 


Als 
Al4 
Al3 





Al2 




















































































































































® 66 microprocessor instructions. vss 
® 15 addressing modes. 
© 178 operational codes. 
@ 1MHz, 2MHz operation. 
© Operates at frequencies as low 
as 200 HZ for even lower power # NCR65C02 BLOCK DIAGRAM 
consumption (pseudo-static: stop during @2 high). 
© Compatible with NMOS 6500 series 
microprocessors. —t-—— REGISTER SECTION CONTROL SECTION ———— 
© 64 K-byte addressable memory. fi i rf 
@ Interrupt capability. a [] moe SY | WNTERAUEY 
, AO -<—ae| REGGTER LOGIC 
© Lower power consumption. ai 
4mA @ 1MHz. ‘ial negigren : : te 132 
F — 
e +5 vied oe supply. i = ren : STAgK POINT ane ee 
© 8-bit bidirectional data bus. eal ee is) a 
é ‘ [= act INSTRUCTION 
@ Bus Compatible with M6800. calied a aera CONTROL 
AT ~<a) 
e@ Non-maskable interrupt. ——— 
fe 2 : SO DRESS: < 
© 40 pin dual-in-line packaging. a rf 
AB wag zr 
: : 5 
© 8-bit parallel processing Ao ma} : FEL = HSE He oo 
® Decimal and binary arithmetic. Mes z fen KO aaras OSCILLATOR 
‘ ’ : All <a sabi e nah EAT ie REGISTER P 4 (OUT) 
© Pipeline architecture. Sail coll LATCH L___ m9 UT) 
5 
© Programmable stack pointer. el = Rae 
® Variable length stack. ats =e] OA Aeus = 
© Optional internal _pullups for 
(RDY, IRO, SO, NMI and RES) iecene 
DATA 
BUS 
ft ©8BIT LINE 





Specifications are subject to 
change without notice. 


| © 1 BIT LINE 


Copyright ©1982 by NCR Corporation, Dayton, Ohio, USA 
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NCR65C02 
= ABSOLUTE MAXIMUM RATINGS: (Vpp = 5.0 V + 5%, Vsg =O V, Ta = 0° to + 70°C) 


RATING SYMBOL 




























SUPPLY VOLTAGE 
INPUT VOLTAGE 
OPERATING TEMP. 
STORAGE TEMP. 


—0.3 to +7.0 
—0.3 to +7.0 
Oto +70 
















































































s PIN FUNCTION 
PIN FUNCTION 

AO - A15 Address Bus 

DO - 07 Data Bus 

TRO * Interrupt Request 

RDY * Ready 

ML Memory Lock 

NMI* Non-Maskable Interrupt 
SYNC Synchronize 

RES * Reset 

S50 * Set Overflow 

NC No Connection 
RW Read/Write 

VOD Power Supply (+5V) 
VSS Internal Logic Ground 
Oo Clock Input 

01, 02 Clock Output 





*This pin has an optional internal pullup for a No Connect condition. 


= DC CHARACTERISTICS 





SYMBOL MIN. TYP. MAX UNIT 


Vss + 0.4 Vv 
Vss + 0.8 Vv 
+30 HA 
+1.0 ie HA 


10 pA 


Output High Voltage 

(loy =-100 "Adc, Vpp =4.75V 

SYNC, Data, AO-A15, R/W) O - Vv 
Out Low Voltage 

(lo_ = 1.6mAdc, Vpp = 4.75V 

SYNC, Data, AO-A15, R/W) VoL Vsg + 0.4 Vv 





Input High Voltage 
Oo (IN) Vio Vsg + 2.4 
Input High Voltage i 
RES, NMI, RDY, TRG, Data, S.0. 
Input Low Voltage 
Qo (IN) 
RES, NMi, RDY, TRO, Data, S.O. 
Input Leakage Current 
(Vin =0 to 5.25V, Vpp = 5.25V) 
With pullups 
Without pullups 
Three State (Off State) Input Current 
(Vin =0.4 to 2.4V, Voc =5.25V) 
Data Lines Its1 = 




















Supply Current f = 1MHz lbp mA 
Supply Current f = 2MHz lop mA 
Capacitance c pF 
(Vin =0, Ta = 25°C, f = 1MHz) 
Logic Cin - 
Data - 
A0-A15, R/W, SYNC Cout - 


Go (IN) Co (IN) & 
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NCR65C02 
s TIMING DIAGRAM 


tro, treo 
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A a 
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04 

02 

ADDR, R/W 
READ DATA 
WRITE DATA 
SYNC 

ML 

RDY, TRG 
NMI, RES 
ie) 




















tr too 














Note: All timing is referenced from a high voltage of 2.0 volts and a low voltage of 0.8 volts. 


= NEW INSTRUCTION MNEMONICS 


HEX MNEMONIC 
80 BRA 
3A DEA 
1A INA 
DA PHX 
BA PHY 
FA PLX 
7A PLY 
9c sTz 
9E STZ 
64 STZ 
74 STZ 
1c TRB 
14 TRB 
oc TSB 
04 TSB 


DESCRIPTION 


Branch relative always [Relative] 

Decrement accumulator [Accum] 

Increment accumulator [Accum] 

Push X on stack [Implied] 

Push Y on stack [Implied] 

Pull X from stack [Implied] 

Pull Y from stack [Implied] 

Store zero [Absolute] 

Store zero [ABS, X] 

Store zero [Zero page] 

Store zero [ZPG,X] 

Test and reset memory bits with accumulator [Absolute] 
Test and reset memory bits with accumulator [Zero page] 
Test and set memory bits with accumulator [Absolute] 
Test and set memory bits with accumulator [Zero page] 


# ADDITIONAL INSTRUCTION ADDRESSING MODES 


HEX MNEMONIC 
72 ADC 
32 AND 
3c BIT 
34 BIT 
D2 CMP 
52 EOR 
7c JMP 
B2 LDA 
12 ORA 
F2 SBC 
92 STA 


DESCRIPTION 
Add memory to accumulator with carry [(ZPG)] 
“AND” memory with accumulator [(ZPG)] 
Test memory bits with accumulator [ABS, X] 
Test memory bits with accumulator [ZPG, X] 
Compare memory and accumulator [(ZPG)] 
“Exclusive Or” memory with accumulator [(ZPG)] 
Jump (New addressing mode) [ABS(IND,X)] 
Load accumulator with memory [(ZPG)] 
“OR" memory with accumulator ((ZPG)] 
Subtract memory from accumulator with borrow [(ZPG)] 
Store accumulator in memory [(ZPG)] 
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=» MICROPROCESSOR PROGRAMMING MODEL 


7 (e) 


ACCUMULATOR A 
7 Q 

INDEX REGISTER Y 
7 i?) 


(x) index REGISTER x 
15 7 $ 
PCH PCL PROGRAM COUNTER PC. 


7 
bots f stack romren s 


# FUNCTIONAL DESCRIPTION 


Timing Control 

The timing control unit keeps track of the instruction 
cycle being monitored. The unit is set to zero each time 
an instruction fetch is executed and is advanced at the 
beginning of each phase one clock pulse for as many 
cycles as is required to complete the instruction. Each 
data transfer which takes place between the registers de- 
pends upon decoding the contents of both the instruc- 
tion register and the timing control unit. 


Program Counter 

The 16-bit program counter provides the addresses which 
step the microprocessor through sequential instructions 
in a program. 


Each time the microprocessor fetches an instruction 
from program memory, the lower byte of the program 
counter (PCL) is placed on the low-order bits of the 
address bus and the higher byte of the program counter 
(PCH) is placed on the high-order 8 bits. The counter is 
incremented each time an instruction or data is fetched 
from program memory. 


Instruction Register and Decode 

Instructions fetched from memory are gated onto the 
internal data bus. These instructions are latched into the 
instruction register, then decoded, along with timing and 
interrupt signals, to generate control signals for the var- 
ious registers. 


Arithmetic and Logic Unit (ALU) 

All arithmetic and logic operations take place in the 
ALU including incrementing and decrementing internal 
registers (except the program counter). The ALU has no 
internal memory and is used only to perform logical and 
transient numerical operations. 


7 ) 
INIv[1]elb] i ]zJc] PROCESSOR STATUS 


REG "P” 





CARRY 1 = TRUE 

ZERO 1 = RESULT ZERO 
TRG DISABLE 1 = DISABLE 
DECIMAL MODE 1 = TRUE 
BRK COMMAND 1 = BRK 
OVERFLOW 1 = TRUE 
NEGATIVE 1 = NEG. 


Accumulator 

The accumulator is a general purpose 8-bit register that 
stores the results of most arithmetic and logic operations, 
and in addition, the accumulator usually contains one of 
the two data words used in these operations. 


Index Registers 

There are two 8-bit index registers (X and Y), which 
may be used to count program steps or to provide an 
index value to be used in generating an effective address. 


When executing an instruction which specifies indexed 
addressing, the CPU fetches the op code and the base 
address, and modifies the address by adding the index 
register to it prior to performing the desired operation. 
Pre- or post-indexing of indirect addresses is possible (see 
addressing modes). 


Stack Pointer 

The stack pointer is an 8-bit register used to control the 
addressing of the variable-length stack on page one. The 
stack pointer is automatically incremented and decre- 
mented under control of the microprocessor to perform 
stack manipulations under direction of either the program 
or interrupts (NMI and IRQ). The stack allows simple 
implementation of nested subroutines and multiple level 
interrupts. The stack pointer should be initialized before 
any interrupts or stack operations occur. 


Processor Status Register 

The 8-bit processor status register contains seven status 
flags. Some of the flags are controlled by the program, 
others may be controlled both by the program and the 
CPU. The 6500 instruction set contains a number of 
conditional branch instructions which are designed to 
allow testing of these flags (see microprocessor program- 
ming model). 
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NCR65C02 
= AC CHARACTERISTICS vopp =5.0v + 5%, Ta = 0°C to 70°C, Load = 1 TTL + 130 pF 



































Parameter | Symbol | Min | Max [Min | Max [Min [Max [Unit 
Delay Time, Og (IN) toO2(0UT)__| tory | - [| 60 | - | 6 [| 20 | 60 | ns 
Delay Time, 8 (OUT) to2 (OUT) | tory: | -20 | 20 | -20 | 20 | -20 | 20 | ns 
Cycle Time [teve [| 1.0 | 5000" [ 0.50 [| 5000" | 0.33 | 5000" | HS 
Clock Pulse Width Low oe ce ee ea ee 
Clock Pulse Width High tey ns 
Address Hold Time ie | a ie tL 
Address Setup Time a ae a 
Access Time ee a Ee a a ee es ee 
Read Data Hold Time Cn he ee 
Read Data Setup Time Cone 2 ee es ee 
Write Data Delay Time Cr Oe ee ee ee ee 
Write Data Hold Time 20 20 | — | ns 
SO Setup Time 100 100 =} 48-+ — nS 
Processor Control Setup Time** 200 150 - | 10 | - | os 
SYNC Setup Time = = 1440 | - [| 100 [ ns 
ML Setup Time = 20 [| = | wo [  - | 00 | ss 
Input Clock Rise/Fall Time tego, trgo = 25 - 25 = 25 nS 





*NCR65C02 can be held static with @2 high. 
**This parameter must only be met to guarantee that the signal will be recognized at the current clock cycle. 


« MICROPROCESSOR OPERATIONAL ENHANCEMENTS 


Function NMOS 6502 Microprocessor 
Indexed addressing across page boundary. | Extra read of invalid address. 






















NCR65C02 Microprocessor 
Extra read of last instruction byte. 














All are NOPs (reserved for future use). 
Op Code Bytes Cycles 
X2 2 2 
X3, X7, XB, XF 1 1 

44 fa 3 
54, D4, F4 2 4 
5C 3 8 
DC, FC 3 4 
additional cycle. 


Two read and one write cycle. 


Some terminate only by reset. Results 
are undefined. 


Execution of invalid op codes. 










Jump indirect, operand = XXFF, Page address does not increment. 





Read/modify/write instructions at 
effective address. 


Decimal flag. 


One read and two write cycles. 





Indeterminate after reset. Initialized to binary mode (D=0) after 
reset and interrupts. 
Valid flag adds one additional cycle. 
BRK is executed, then interrupt is 

executed. 






















Flags after decimal operation. Invalid N, V and Z flags. 
Interrupt after fetch of BRK instruc- Interrupt vector is loaded, BRK vector 
tion. is ignored. 

















= MICROPROCESSOR HARDWARE ENHANCEMENTS 








Function NMOS 6502 


Assertion of Ready RDY during Ignored. Stops processor during 02. 
write operations. 


Unused input-only pins (TRO, NMI, Must be connected to low impedance [Connected internally by a high- 
RDY, RES, SO). signal to avoid noise problems. resistance to Vpp (approximately 250 
K ohm.) 
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NCR65C02 
» ADDRESSING MODES 


Fifteen addressing modes are available to the user of the 
NCR65CO2 microprocessor. The addressing modes are 
described in the following paragraphs: 


Implied Addressing [Implied] 

In the implied addressing mode, the address containing 
the operand is implicitly stated in the operation code of 
the instruction. 


Accumulator Addressing [Accum] 

This form of addressing is represented with a one byte 
instruction and implies an operation on the accumu- 
lator. 


Immediate Addressing [Immediate] 

With immediate addressing, the operand is contained in 
the second byte of the instruction; no further memory 
addressing is required. 


Absolute Addressing [Absolute] 

For absolute addressing, the second byte of the instruc- 
tion spécifies the eight low-order bits of the effective 
address, while the third byte specifies the eight high-order 
bits. Therefore, this addressing mode allows access to the 
total 64K bytes of addressable memory. 


Zero Page Addressing [Zero Page] 

Zero page addressing allows shorter code and execution 
times by only fetching the second byte of the instruction 
and assuming a zero high address byte. The careful use 
of zero page addressing can result in significant increase 
in code efficiency. 


Absolute Indexed Addressing [ABS, X or ABS, Y] 
Absolute indexed addressing is used in conjunction with 
X or Y index register and is referred to as ‘Absolute, X,’’ 
and ‘‘Absolute, Y.’’ The effective address is formed by 
adding the contents of X or Y to the address contained 
in the second and third bytes of the instruction. This 
mode allows the index register to contain the index or 
count value and the instruction to contain the base 
address. This type of indexing allows any location refer- 
encing and the index to modify multiple fields, resulting 
in reduced coding and execution time. 


Zero Page Indexed Addressing [ZPG, X or ZPG, Y] 

Zero page absolute addressing is used in conjunction 
with the index register and is referred to as ‘’Zero Page, 
X" or ‘‘Zero Page, Y.’’ The effective address is calculated 
by adding the second byte to the contents of the index 
register. Since this is a form of ‘Zero Page’ addressing, 
the content of the second byte references a location in 
page zero. Additionally, due to the ‘‘Zero Page’’ address- 
ing nature of this mode, no carry is added to the high- 
order eight bits of memory, and crossing of page boun- 
daries does not occur. 


Relative Addressing [Relative] 
Relative addressing is used only with branch instructions; 


it establishes a destination for the conditional branch. 
The second byte of the instruction becomes the operand 
which is an “Offset’’ added to the contents of the pro- 
gram counter when the counter is set at the next in- 
struction. The range of the offset is —128 to +127 
bytes from the next instruction. 

Zero Page Indexed Indirect Addressing [(IND, X)] 

With zero page indexed indirect addressing (usually re- 
ferred to as indirect X) the second byte of the instruction 
is added to the contents of the X index register; the 
carry is discarded. The result of this addition points to a 
memory location on page zero whose contents is the low- 
order eight bits of the effective address. The next mem- 
ory location in page zero contains the high-order eight 
bits of the effective address. Both memory locations 
specifying the high- and low-order bytes of the effective 
address must be in page zero. 


*Absolute Indexed Indirect Addressing [ABS(IND, X)] 
(Jump Instruction Only) 

With absolute indexed indirect addressing the contents of 
the second and third instruction bytes are added to the 
X register. The result of this addition, points to a memory 
location containing the lower-order eight bits of the 
effective address. The next memory location contains 
the higher-order eight bits of the effective address. 


Indirect Indexed Addressing {(IND), Y] 

This form of addressing is usually referred to as Indirect, 
Y. The second byte of the instruction points to a mem- 
ory location in page zero. The contents of this memory 
location are added to the contents of the Y index regis- 
ter, the result being the low-order eight bits of the effec- 
tive address. The carry from this addition is added to the 
contents of the next page zero memory location, the 
result being the high-order eight bits of the effective 
address. 


*Zero Page Indirect Addressing [(ZPG)] 
in the zero page indirect addressing mode, the second 
byte of the instruction points to a memory location on 
page zero containing the low-order byte of the effective 
address. The next location on page zero contains the 
high-order byte of the effective address. 


Absolute Indirect Addressing [(ABS)] 

(Jump Instruction Only) 

The second byte of the instruction contains the low-order 
eight bits of a memory location. The high-order eight 
bits of that memory location is contained in the third 
byte of the instruction. The contents of the fully speci- 
fied memory location is the low-order byte of the effec- 
tive address. The next memory location contains the 
high-order byte of the effective address which is loaded 
into the 16 bit program counter. 


. NOTE: * = New Address Modes 
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= SIGNAL DESCRIPTION 


Address Bus (A0-A15) 

A0-A15 forms a 16-bit address bus for memory and |/O 

exchanges on the data bus. The output of each address 

line is TTL compatible, capable of driving one standard 
» TTL load and 130pF. 


Clocks (G9, 41, and G2) 

@o is a TTL level input that is used to generate the inter- 
nal clocks in the 6502. Two full level output clocks are 
generated by the 6502. The 2 clock output is in phase 
with O09. The 01 output pin is 180° out of phase with Oo. 
(See timing diagram.) 


Data Bus (D0-D7) 

The data lines (DO-D7) constitute an 8-bit bidirectional 
data bus used for data exchanges to and from the device 
and peripherals. The outputs are three-state buffers 
capable of driving one TTL load and 130 pF. 


Interrupt Request (IRQ) 

This TTL compatible input requests that an interrupt 
sequence begin within the microprocessor. The IRQ is 
sampled during @2 operation; if the interrupt flag in the 
processor status register is zero, the current instruction 
is completed and the interrupt sequence begins during 
@4. The program counter and processor status register 
are stored in the stack. The microprocessor will then set 
the interrupt mask flag high so that no further IRQs 
may occur. At the end of this cycle, the program counter 
low will be loaded from address FFFE, and program 
counter high from location FFFF, transferring program 
control to the memory vector located at these addresses. 
The RDY signal must be in the high state for any inter- 
rupt to be tecognized. A 3K ohm external resistor should 
be used for proper wire OR operation. 


Memory Lock (ML) = 

In a multiprocessor system, the ML output indicates the 
need to defer the rearbitration of the next bus cycle to 
ensure the integrity of read-modify-write instructions. 
ML goes low during ASL, DEC, INC, LSR, ROL, ROR, 
TRB, TSB memory referencing instructions. This signal 
is low for the modify and write cycles. 


Non-Maskable Interrupt (NMI) 

A negative-going edge on this input requests that a non- 
maskable interrupt sequence be generated within the 
microprocessor. The NMI is sampled during @2; the cur- 
rent instruction is completed and the interrupt sequence 
begins during @1. The program counter is loaded with 
the interrupt vector from locations FFFA (low byte) 
and FFFB (high byte}, thereby transferring program con- 
trol to the non-maskable interrupt routine. 


Note: Since this interrupt is non-maskable, another NMI 
can occur before the first is finished. Care should be taken 
when using NMI to avoid this. 


NCR65C02 


Ready (RDY) : 

This input allows the user to single-cycle the micropro- 
cessor on all cycles including write cycles. A negative 
transition to the low state, during or coincident with 
phase one (04), will halt the microprocessor with the out- 
put address lines reflecting the current address being 
fetched. This condition will remain through a subsequent 
phase two (@2) in which the ready signal is low. This fea- 
ture allows microprocessor interfacing with low-speed 
memory as well as direct memory access (DMA). 


Reset (RES) 

This input is used to reset the microprocessor. Reset 
must be held low for at least two clock cycles after 
VDD reaches operating voltage from a power down. A 
Positive transistion on this pin will then cause an initiali- 
zation sequence to begin. Likewise, after the system has 
been operating, a low on this line of at least two cycles 
will cease microprocessing activity, followed by initial- 
ization after the positive edge on RES. 


When a positive edge is detected, there is an initialization 
sequence lasting six clock cycles. Then the interrupt 
mask flag is set, the decimal mode is cleared, and the pro- 
gram counter is loaded with the restart vector from loca- 
tions FFFC (low byte) and FFFD (high byte). This is 
the start location for program control. This input should 
be high in normal operation. 


Read/Write (R/W) 

This signal is normally in the high state indicating that 
the microprocessor is reading data from memory or |/O 
bus. In the low state the data bus has valid data from the 
microprocessor to be stored at the addressed memory 
location. 


Set Overflow (SO) 

A negative transition on this line sets the overflow bit in 
the status code register. The signal is sampled on the trail- 
ing edge of 07. 


Synchronize (SYNC) 

This output line is provided to identify those cycles dur- 
ing which the microprocessor is doing an OP CODE 
fetch. The SYNC line goes high during 01 of an OP CODE 
fetch and stays high for the remainder of that cycle. If 
the RDY line is pulled low during the 01 clock pulse in 
which SYNC went high, the processor will stop in its 
current state and will remain in the state until the RDY 
line goes high. In. this manner, the SYNC signal can be 
used to control RDY to cause single instruction execu- 
tion. 
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NCR65C02 
« INSTRUCTION SET — ALPHABETICAL SEQUENCE 


ADC 
AND 
ASL 
BCC 
BCS 
BEQ 
BIT 
BMI 
BNE 
BPL 
*BRA 
BRK 
BVC 
BVS 
CLC 
CLD 
cul 
CLV 
CMP 
CPx 
CPY 
*DEA 
DEC 
DEX 
DEY 
EOR 
*INA 
INC 
INX 
INY 
JMP 
JSR 
LDA 


Note: 


Add Memory to Accumulator with Carry 
“AND” Memory with Accumulator 
Shift One Bit Left 

Branch on Carry Clear 

Branch on Carry Set 

Branch on Result Zero 

Test Memory Bits with Accumulator 
Branch on Result Minus 

Branch on Result not Zero 

Branch on Result Plus 

Branch Always 

Force Break 

Branch on Overflow Clear 

Branch on Overflow Set 

Clear Carry Flag 

Clear Decimal Mode 

Clear Interrupt Disable Bit 

Clear Overflow Flag 

Compare Memory and Accumulator 
Compare Memory and Index X 
Compare Memory and Index Y 
Decrement Accumulator 

Decrement by One 

Decrement Index X by One 
Decrement Index Y by One 
“Exclusive- or’ Memory with Accumulator 
Increment Accumulator 

Increment by One 

Increment Index X by One 
Increment Index Y by One 

Jump to New Location 

Jump to New Location Saving Return Address 
Load Accumulator with Memory 


* = New Instruction 


s MICROPROCESSOR OP CODE TABLE 


Lox 
LDY 
LSR 
NOP 
ORA 
PHA 
PHP 

*PHX 

* PHY 
PLA 
PLP 

*PLX 

*PLY 
ROL 
ROR 
RTI 
RTS 
SBC 
SEC 
SED 
SEI 
STA 
STX 
STY 

“STZ 
TAX 
TAY 

*TRB 

*TSB 
TSX 
TXA 
TXS 
TYA 


Load Index X with Memory 

Load Index Y with Memory 

Shift One Bit Right 

No Operation 

“OR" Memory with Accumulator 
Push Accumulator on Stack 

Push Processor Status on Stack 
Push Index X on Stack 

Push Index Y on Stack 

Pull Accumulator from Stack 

Pull Processor Status from Stack 
Pull Index X from Stack 

Pull Index Y from Stack 

Rotate One Bit Left 

Rotate One Bit Right 

Return from Interrupt 

Return from Subroutine 

Subtract Memory from Accumulator with Borrow 
Set Carry Flag 

Set Decimal Mode 

Set Interrupt Disable Bit 

Store Accumulator in Memory 
Store Index X in Memory 

Store Index Y in Memory 

Store Zero in Memory 

Transfer Accumulator to Index X 
Transfer Accumulator to Index Y 
Test and Reset Memory Bits with Accumulator 
Test and Set Memory Bits with Accumulator 
Transfer Stack Pointer to Index X 
Transfer Index X to Accumulator 
Transfer Index X to Stack Pointer 
Transfer Index Y to Accumulator 


































































































































A B (2) 
ASL TSB* ORA ASL 
A abs abs abs 
on ae 
INA* TRB* ORA ASL 
A abs abs, X | abs, X | 
ROL BIT AND ROL 2 
A abs abs abs 
DEA* BIT*Tt AND | ROL 
A abs, X bs, X |_abs, x 
iz LSR JMP EOR LSR 
A abs abs abs 
PHY* EOR LSR 
abs, X | abs, X 
ROR JMP ADC ROR 
A (abs) abs abs 
PLY* JMP*t ADC 
abs (ind, X)| abs, X abs, X 
TXA STY STA STX 
abs abs abs 
TXS SsTz* STA stz* 
abs abs, X 
TAX LOY LDA 
abs abs 
LDY LDA LOX 
abs, X abs, X 










































































Note: * = New OP Codes 
Note: t = New Address Modes 
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* OPERATIONAL CODES, EXECUTION TIME, AND MEMORY 
REQUIREMENTS 














OPERATION 











A+M+CoA 
AAM*A {1) 
|Z __B-0 a | 





Branch if C=O (2) 
Branch if C=1 (2) 





NCR65C02 
















BEQ | Branch if Z=1 (2) 
BIT JAAM {4.5)| 89 
BMI | Branch if N=1 (2) 


BPL [Branch if N=0 (2) 










BNE |sroncn if Z=0 (2) 


EL 
BRA | Branch Always (2) 
BRK | Break 

BVC | Branch if V=0 (2) 


BVS | Branch it V=1 (2) 
cic |o*c 
cio loo 


CLI /O*1 
CLV /O+V 
CMP /A-M is) 
CPx = 
























cPy 
DEA 
DEC 
OEX|x-1*x 
OEY|Y-1*¥ 


EORJAVM*A 

INA |K+ 124A 

INC |M+1*M (1) 
INX |X +1*X 

INY |Y¥+1*Y 

H+ 

IMP | Jump to new loc 

JSR | Jump Subroutine 
LDA|M+A oD) 
LDX|M*x a) 
LOY|M+Y (1) 


LSR | 0+ 3) a) 
NoP|PC +1*PC 
ORAJAVM*A a 
PHA|A*M, S-1*S 

PHP [P*M, S-1°S 


1tA 


x 
Y- 
A 
M-1*M (1) 
x. 




























NNNNNINNNNNINAN- 











PHX|X*M,S-1¢S 
PHY|Y*M, S.1*S 
PLA|S+1*S Mora 
PLP |S+1*S M,*P 
PLX |S+1*S Mo*x 








PLY |S+1*S Mo*y 
ROL| CF ——g-tga a) 
ROR| Ci. ——g a) 
RTI | Return from Inter. 
RTS | Return trom Subr. 





SBC |A-M-T*A 41,3) 
SEC j1*C 
SEO /1°*0 
SEI |11 
STA|A*M 





jt. 
STX|X*M 
STY|V¥*M 
STZ |OO*M 
TAX/A*X 
TAYIA*Y 











TRBJAAM*M (4) 
TSB /AVM=*M (4) 
TSx |S*x 

Txs [x8 























TXS|X*S 

















































































































TYAIY*A 




















Notes: 

1. Add 1 to ‘‘n’’ if page boundary is crossed. X Index X 

2. Add 1 to ‘“‘n’” if branch occurs to same page. Y Index Y 
Add 2 to “’n” if branch occurs to different page. A Accumulator 
Add 1 to ‘'n” if decimal mode. M Memory per effective address 
V bit equals memory bit 6 prior to execution. Ms Memory per stack pointer 
N bit equals memory bit 7 prior to execution, 
*5, The immediate addressing mode of the BIT instruction leaves bits 6 & 7 

(V & N) in the Processor Status Code Register unchanged. 


Po 





eS 4 


Exclusive or 





n_ No. Cycles 
# No. Bytes 
Mg Memory bit 6 
M7 Memory bit 7 
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Warning 


Appendix B 


Directory of Built-in Subroutines 


Here is a list of useful subroutines in the Apple Ie’s Monitor. To use 
these subroutines from machine-language programs, store data 
into the specified memory locations or microprocessor registers as 
required by the subroutine and execute a JSR to the subroutine’s 
starting address. After the subroutine performs its function, it 
returns with the 65C02’s registers changed as described. 


Do not jump into the middle of Monitor subroutines. Although 
the starting addresses are the same for all models of the 
Apple Il, the actual code is different. 


BASICIN _ Read the keyboard $C305 


When the 80-column firmware is active, BASICIN is used instead of 
KEYIN. BASICIN operates like KEYIN except that it displays a solid, 
nonblinking cursor instead of a blinking checkerboard cursor. 


BASICOUT Output to screen $C307 


When the 80-column firmware is active, BASICOUT is used instead 
of COUT1. BASICOUT displays the character in the accumulator on 
the Apple Ile’s screen at the current output cursor position and 
advances the output cursor. It places the character using the setting 
of the Normal/Inverse location. It handles control codes; see 
Table 3-3b. BASICOUT returns with all registers intact. 


BELL Output a bell character $FF3A 
BELL writes a bell (Control-G) character to the current output 
device. It leaves the accumulator holding $87. 

BELL1 Sends a beep to the speaker $FBDD 
BELL1 generates a 1-kHz tone in the Apple Ile’s speaker for 

0.1 second. It scrambles the A and X registers. 

CLREOL Clear to end of line $FC9C 
CLREOL clears a text line from the cursor position to the right edge 
of the window. CLREOL destroys the contents of A and Y. 
CLEOLZ Clear to end of line $FC9OE 


CLEOLZ clears a text line to the right edge of the window, starting at 
the location given by base address BASL, which is indexed by the 
contents of the Y register. CLEOLZ destroys the contents of A 

and Y. 


CLREOP Clear to end of window $FC42 
CLREOP clears the text window from the cursor position to the 
bottom of the window. CLREOP destroys the contents of A and Y. 


CLRSCR Clear the low-resolution screen $F832 


CLRSCR clears the low-resolution graphics display to black. If you 
call CLRSCR while the video display is in text mode, it fills the 
screen with inverse-mode at-sign (@) characters. CLRSCR destroys 
the contents of A and Y. 


CLRTOP.- Clear the low-resolution screen $F836 
CLRTOP is the same as CLRSCR (above), except that it clears only 
the top 40 rows of the low-resolution display. 

COUT Output a character $FDED 


COUT calls the current character output subroutine. The character 
to be output should be in the accumulator. COUT calls the 
subroutine whose address is stored in CSW (locations $36 and $37), 
which is usually one of the standard character output subroutines, 
COUT1 or BASICOUT. 
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COUT1 Output to screen $FDFO 


COUT! displays the character in the accumulator on the Apple Ile’s 
screen at the current output cursor position and advances the 
output cursor. It places the character using the setting of the 
Normal/Inverse location. It handles the codes for carriage return, 
linefeed, backspace, and bell. It returns with all registers intact. 


CROUT Generate a carriage return character $FD8E 


CROUT sends a carriage return character to the current output 
device. 


CROUT1 Generate carriage return, clear rest of line $FD8B 


CROUT1 clears the screen from the current cursor position to the 
edge of the text window, then calls CROUT. 


GETLN Get an input line with prompt $FD6A 


GETIN is the standard input subroutine for entire lines of 
characters, as described in Chapter 3. Your program calls GETLN 
with the prompt character in location $33; GETLN returns with the 
input line in the input buffer (beginning at location $0200) and the 
X register holding the length of the input line. 


GETLNZ __ Get an input line $FD67 


GETLNZ is an alternate entry point for GETLN that sends a carriage 
return to the standard output, then continues into GETLN. 


GETLN1 Get an input line, no prompt $FD6F 


GETIN1 is an alternate entry point for GETLN that does not issue a 
prompt before it accepts the input line. If, however, the user 
cancels the input line, either with too many backspaces or with a 
Control-X, then GETLN1 will issue the contents of location $33 as a 
prompt when it gets another line. 


HLINE Draw a horizontal line of blocks $F819 


HLINE draws a horizontal line of blocks of the color set by SETCOL 
on the low-resolution graphics display. Call HLINE with the vertical 
coordinate of the line in the accumulator, the leftmost horizontal 
coordinate in the Y register, and the rightmost horizontal 
coordinate in location $2C. HLINE returns with A and Y scrambled 
X intact. 
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HOME Home cursor and clear $FC58 


HOME clears the display and puts the cursor in the home position: 
the upper-left corner of the screen. 


IOREST Restore all registers $FF3F 


IOREST loads the 65C02’s internal registers with the contents of 
memory locations $45 through $49. 


IOSAVE Save all registers $FF4A 


IOSAVE stores the contents of the 65C02’s internal registers in 
locations $45 through $49 in the order A, X, Y, P, S. The contents 
of A and X are changed and the decimal mode is cleared. 


KEYIN Read the keyboard $FD1B 


KEYIN is the keyboard input subroutine. It reads the Apple Ile’s 
keyboard, waits for a keypress, and randomizes the random number 
seed at $4E-$4F. When a key is pressed, KEYIN removes the 
blinking cursor from the display and returns with the keycode in the 
accumulator. KEYIN is described in Chapter 3. 


MOVE Move a block of memory $FE2C 


MOVE copies the contents of memory from one range of locations 
to another. This subroutine is the same as the MOVE command in 
the Monitor, except that it takes its arguments from pairs of 
locations in memory, low-byte first. The destination address must 
be in A4 ($42-$43), the starting source address in Al ($3C-$3D), 
and the ending source address in A2 ($3E-3F) when your program 
calls MOVE. Register Y must contain $00 when your program calls 
MOVE. 


NEXTCOL Increment color by 3 $F85F 
NEXTCOL adds 3 to the current color (set by SETCOL) used for low- 
resolution graphics. 

PLOT Plot on the low-resolution screen $F800 


PLOT puts a single block of the color value set by SETCOL on the 
low-resolution display screen. The block’s vertical position is 
passed in the accumulator, its horizontal position in the Y register. 
PLOT returns with the accumulator scrambled, but X and Y intact. 
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PRBLNK Print three spaces $F948 


PRBLNK outputs three blank spaces to the standard output device. 
On return, the accumulator usually contains $A0, the X register 
contains 0. 


PRBL2 Print many blank spaces $FO4A 


PRBL2 outputs from 1 to 256 blanks to the standard output device. 
Upon entry, the X register should contain the number of blanks to — 
be output. If X=$00, then PRBL2 will output 256 blanks. 


PRBYTE Print a hexadecimal byte $FDDA 


PRBYTE outputs the contents of the accumulator in hexadecimal on 
the current output device. The contents of the accumulator are 
scrambled. 


PREAD Read a hand control $FBIE 


PREAD returns a number that represents the position of a hand 
control. You pass the number of the hand control in the X register. 
If this number is not valid (not equal to 0, 1, 2, or 3), strange things 
may happen. PREAD returns with a number from $00 to $FF in the 
Y register. The accumulator is scrambled. 


PRERR Print ERR $FF2D 
PRERR sends the word ERR, followed by a bell character, to the 
standard output device. On return, the accumulator is scrambled. 
PRHEX Print a hexadecimal digit $FDE3 


PRHEX prints the lower nibble of the accumulator as a single 
hexadecimal digit. On return, the contents of the accumulator are 
scrambled. 


PRNTAX Print A and X in hexadecimal $F941 


PRNTAX prints the contents of the A and X registers as a four-digit 
hexadecimal value. The accumulator contains the first byte output, 
the X register contains the second. On return, the contents of the 
accumulator are scrambled. 


RDCHAR _ Get an input character or escape code $FD35 


RDCHAR is an alternate input subroutine that gets characters from 
the standard input subroutine, and also interprets the escape codes 
listed in Chapter 3. 
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RDKEY Get an input character $FDOC 


RDKEY is the character input subroutine. It places a blinking cursor 
on the display at the cursor position and jumps to the subroutine 
whose address is stored in KSW (locations $38 and $39), usually the 
standard input subroutine KEYIN, which returns with a character in 
the accumulator. 


READ Read a record from a cassette $FEFD 


READ reads a series of tones at the cassette input port, converts 
them to data bytes, and stores the data in a specified range of 
memory locations. Before calling READ, the address of the first 
byte must be in A1 ($3C-$3D) and the address of the last byte must 
be in A2 ($3E-$3F). 


READ keeps a running exclusive-OR of the data bytes in CHKSUM 
($2E). When the last memory location has been filled, READ reads 
one more byte and compares it with CHKSUM. If they are equal, 
READ sends out a beep and returns; if not, it sends the word ERR 
through COUT, sends the beep, and returns. 


SCRN Read the low-resolution graphics screen $F871 


SCRN returns the color value of a single block on the low-resolution 
graphics display. Call it with the vertical position of the block in the 
accumulator and the horizontal position in the Y register. Call it as 
you would call PLOT (above). The color of the block will be 
returned in the accumulator. No other registers are changed. 


SETCOL _ Set low-resolution graphics color $F864 


SETCOL sets the color used for plotting in low-resolution graphics 
to the value passed in the accumulator. The colors and their values 
are listed in Table 2-6. 


SETINV Set inverse mode $FE80 


SETINV sets the dislay format to inverse. COUT1 will then display 
all output characters as black dots on a white background. The 
Y register is set to $3F, all others are unchanged. 


SETNORM Set normal mode $FE84 


SETNORM sets the display format to normal. COUT1 will then 
display all output characters as white dots on a black background. 
On return, the Y register is set to $FF, all others are unchanged. 
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VERIFY Compare two blocks of memory $FE36 


VERIFY compares the contents of one range of memory to another. 
This subroutine is the same as the VERIFY command in the 

Monitor, except it takes its arguments from pairs of locations in 
memory, low-byte first. The destination address must be in A4 
($42-$43), the starting source address in Al ($3C-$3D), and the 
ending source address in A2 ($3E-$3F) when your program calls 
VERIFY. 


VLINE Draw a vertical line of blocks $F828 


VLINE draws a vertical line of blocks of the color set by SETCOL on 
the low-resolution display. You should call VLINE with the 
horizontal coordinate of the line in the Y register, the top vertical 
coordinate in the accumulator, and the bottom vertical coordinate 
in location $2D, VLINE will return with the accumulator scrambled. 


WAIT Delay $FCA8 


WAIT delays for a specific amount of time, then returns to the 
program that called it. The amount of delay is specified by the 
contents of the accumulator. The delay is 1/2(26+27A+5A42) 
microseconds, where A is the contents of the accumulator. WAIT 
returns with the accumulator zeroed and the X and Y registers 
undisturbed. 


WRITE Write a record on a cassette $FECD 


WRITE converts the data in a range of memory to a series of tones at 
the cassette output port. Before calling WRITE, the address of the 
first data byte must be in Al ($3C-$3D) and the address of the last 
byte must be in A2 ($3E-$3F). The subroutine writes a ten-second 
continuous tone as a header, then writes the data followed by a one- 
byte checksum. 
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Appendix C 


Apple Il Family Differences 


This appendix lists the differences among the Apple II Plus, the 
original, enhanced, and extended keyboard Apple Ile’s, and the 
Apple IIc. 


If you’re trying to write software to run on more than one version of 
the Apple II, this appendix will help you avoid unexpected 
problems of incompatibility. 


The differences are listed here in approximately the order you are 
likely to encounter them: obvious differences first, technical details 
later. Each entry in the list includes references to the chapters in 
this manual where the item is described. 


Keyboard 


The Apple Ile and Apple IIc have a 63-key uppercase and lowercase 
keyboard. The keyboard includes fully operational Shift and Caps 
Lock keys. It also includes four directional arrow keys for moving the 
cursor. Chapter 2 includes a description of the keyboard. The 
cursor-motion keys are described in Chapter 3. 


The extended keyboard Ile keyboard includes an 18-key numeric 
keypad, for a total of 81 keys. 
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Apple keys 


The keyboards for the original and enhanced Apple Ile’s and the 
Apple IIc have two keys marked with the Apple logo. These keys, 
called the Open Apple key and Solid Apple key, are used with the 
Reset key to select special reset functions. They are connected to the 
buttons on the hand controls, so they can be used for special 
functions in programs. 


On the extended keyboard Ile, the Solid Apple key is replaced by 
the Option key and the Open Apple key is simply referred to as the 
Apple key. 


The Apple II and the Apple II Plus do not have Apple keys. 


Character sets 


The Apple Ile and Apple IIc can display the full ASCII character set, 
uppercase and lowercase. For compatibility with older Apple II’s, 
the standard display character set includes flashing uppercase 
instead of inverse-format lowercase; you can also switch to an 
alternate character set with inverse lowercase and uppercase but no 
flashing. Chapter 2 includes a description of the display character 
sets. Chapter 3 tells you how to switch display formats. 


The Apple IIc and the enhanced and extended keyboard Apple Ile 
include a set of “graphic” text characters, called MouseText 
characters, that replace some of the inverse uppercase characters in 
the alternate character set of the original Apple Ile. MouseText 
characters are described in Chapter 2. 


80-column display 


With the addition of an 80-column text card, the Apple Ile can 
display 80 columns of text. The 80-column display is completely 
compatible with both graphics modes—you can even use it in 
mixed mode. (If you prefer, you can use an old-style 80-column 
card in an expansion slot instead.) Chapter 2 includes a description 
of the 80-column display. 


The Extended 80-Column Text Card is a standard accessory in the 
enhanced Ile, and comes installed in the extended keyboard Ile. 
The Apple IIc has a built-in Extended 80-Column Text Card. 
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Escape codes and control characters 


On the Apple Ile and Apple IIc, the display features mentioned 
above (and many others not mentioned) can be controlled from 
the keyboard by escape sequences and from programs by control 
characters. Chapter 3 includes descriptions of those escape codes 
and control characters. 


Built-in Language Card 


The 16K bytes of RAM you add to the Apple II Plus by installing the 
Language Card is built into the Apple Ile and Apple IIc, giving the 
Apple Ile a standard memory size of 64K bytes. (The Apple IIc has a 
built-in Extended 80-Column Text Card as well, giving it a standard 
memory size of 128K bytes.) In the Apple Ile, this 16K-byte block of 
memory is called the bank-switched memory. It’s described in 
Chapter 4. 


Auxiliary memory 


By installing the Apple Ile Extended 80-Column Text Card, you can 
add an alternate 64K bytes of RAM to the Apple Ile. Chapter 4 tells 
you how to use the additional memory. (The Extended 80-Column 
Text Card also provides the 80-column display option.) 


The Extended 80-Column Text Card is a standard accessory in the 
enhanced IIe, and comes installed in the extended keyboard Ile. 


The Apple IIc has a built-in Extended 80-Column Text Card. 


Auxiliary slot 


In addition to the expansion slots on the Apple II Plus, the 
Apple Ile has a special slot that is used either for the 80-Column 
Text Card or for the Extended 80-Column Text Card. This slot is 
identified in Chapter 1 and described in Chapter 7. 


The Apple IIc has the functions of the auxiliary slot built in. 
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Back panel and connectors 


The Apple Ile has a metal back panel with space for several D-type 
connectors. Each peripheral card you add comes with a connector 
that you install in the back panel. Chapter 1 includes a description 
of the back panel; for details, see the installation instructions 
supplied with the peripheral cards. 


The Apple IIc back panel has seven built-in connectors. 


Soft switches 


The display and memory features of the Apple Ile and the Apple Ic 
are controlled by soft switches like the ones on the Apple II Plus. On 
the Apple IIe and the Apple IIc, programs can also read the settings 
of the soft switches. Chapter 2 describes the soft switches that 
control the display features, and Chapter 4 describes the soft 
switches that control the memory features. 


Built-in self-test 


The Apple Ile has built-in firmware that includes a self-test routine. 
The self-test is intended primarily for testing during manufacturing, 
but you can run it to be sure the Apple Ile is working correctly. The 
self-test is described in Chapter 4. 


The Apple IIc also has built-in diagnostics. 


Forced reset 


Some programs on the Apple II Plus take control of the reset 
function to keep users from stopping the machine and copying the 
program. The Apple Ile and Apple IIc have a forced reset that writes 
over the program in memory. By using the forced reset, you can 
restart the Apple Ile (or Apple IIc) without turning power off and on 
and causing unnecessary stress on the circuits. The forced reset is 
described in Chapter 4. 
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These features are described in 
Chapter 7, 


Interrupt handling 


Even though most application programs don’t use interrupts, the 
Apple Ile (and Apple IIc) provide for interrupt-driven programs. 
For example, the 80-column firmware periodically enables 
interrupts while it is clearing the display (normally a long time to 
have interrupts locked out). Interrupts are discussed in Chapter 6. 


Vertical sync for animators 


Programs with animation on the Apple Ile and Apple IIc can stay in 
step with the display and avoid flickering objects in their displays. 
Chapter 7 includes a description of the video generation and the 
vertical sync. 


Signature byte 


A program can find out whether it’s running on an Apple Ile, 

Apple IIc, Apple III (in emulation mode), or older model Apple II 
by reading the byte at location $FBB3 in the System Monitor. In the 
Apple Ile Monitor, this byte’s value is $06; in the Autostart Monitor 
(the standard Monitor on the Apple II Plus), its value is $EA. Cif you 
start up with DOS and switch to Integer BASIC, the Autostart 
Monitor is active and the value at location $FBB3 is $EA, even on 
an Apple Ile.) Obviously, there are lots of other locations that have 
different values in the different versions of the Monitor; location 
$FBB3 was chosen because it will have the value $06 even in future 
revisions of the Apple IIe Monitor. 


Hardware implementation 


The hardware implementation of the Apple Ile is radically different 
from the Apple II and Apple II Plus. Three of the more important 
differences are 


O the custom ICs: the IOU and MMU 


Q the video hardware, which uses ROM to generate both text and 
graphics 
O the peripheral data bus, which is fully buffered 
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For more information about the The Apple IIc 

Apple lic, see the Apple lic 

Focrical reirenee, O shares some of the custom ICs of the Apple Ile 
O has some new ones all its own 


O lacks the slots of the Apple IIe, replacing some of them with built- 
in I/O ports 
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Appendix D 


Operating Systems 
and Languages 


This appendix is an overview of the characteristics of operating 
systems and languages when run on the Apple Ile. It is not intended 
to be a full account. For more information, refer to the manuals that 
are provided with each product. 


Operating systems 


This section discusses the operating systems that can be used with 
the Apple Ile. 


ProDOS 


ProDOS is the preferred disk operating system for the Apple Ile. It 
supports interrupts, startup from drives other than a Disk Il, and all 
other hardware and firmware features of the Apple Ile. 


DOS 3.3 


The Apple Ile works with DOS 3.3. The Apple Ile can also access 
DOS 3.2 disks by using the BASICS disk. However, neither version 
of DOS takes full advantage of the features of the Apple Ile. DOS 
support is provided only for the sake of Apple II series 
compatibility. 
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Pascal operating system 


The Apple II Pascal operating system was developed from the UCSD 
Pascal system from the University of California at San Diego. While 
it shares many characteristics of that system, it has been extended 
by Apple in several areas. 


Pascal versions 1.2 and later support interrupts and all the hardware 
and firmware features of the Apple Ile. 


The Apple II Pascal system uses a disk format different from either 
ProDOS or DOS 3.3. 


CP/M 


CP/M is an operating system developed by Digital Research that 
runs on either the Intel 8080 or Zilog Z80 microprocessors. This 
means that a coprocessor peripheral card, available from several 
manufacturers for the Apple Ile, is required to run CP/M. Several 
versions of CP/M from 1.4 through 3.0 and later can be run on an 
Apple Ile with an appropriate coprocessor card. 


Languages 


This section discusses special techniques to use, and characteristics 
to be aware of, when using Apple programming languages with the 
Apple Ile. 


Assembly language 


An aid for assembly-language Programs written in assembly language have the potential of 
programming Is the ProDOs extracting the most speed and efficiency from your Apple Ile, but 
Assembler Tools manual 

(A2W0013). they also require the most effort on your part. 
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Applesoft BASIC 


The focus of the chapters in this manual is assembly language, and 
so most addresses and values are given in hexadecimal notation. 
Appendix E in this manual includes tables to help you convert from 
hexidecimal to the decimal notation you will need for BASIC. 


In BASIC, use a PEEK to read a location (instead of the LDA used in 
assembly language), and a POKE (instead of STA) to write to a 
location. If you read a hardware address from a BASIC program, 
you get a value between 0 and 255. Bit 7 holds a place value of 128, 
so if a soft switch is on, its value will be equal to or greater than 128; 
if the switch is off, the value will be less than 128. 


Integer BASIC 


Integer BASIC is not included in the Apple Ile firmware. If you want 
to run it on your Apple Ile, you must use DOS 3.3 to load it in to the 
system. ProDOS does not support Integer BASIC. 


Pascal language 


The Pascal language works on the Apple Ile under versions 1.1 and 
later of the Pascal Operating System. However, for best 
performance, use Pascal 1.2 or a later version. 


Fortran 


Fortran works under version 1.1 of the Pascal Operating System, 
which does not detect or use certain Apple Ile features, such as 
auxiliary memory. Therefore, Fortran does not take advantage of 
these features. 
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Appendix E 


Conversion Tables 


This appendix briefly discusses bits and bytes and what they can 
represent. It also contains conversion tables for hexadecimal to 
decimal and negative decimal, for low-resolution display dot 

patterns, display color values, and a number of eight-bit codes. 


These tables are intended for convenient reference. This appendix 
is not intended as a tutorial for the materials discussed. The brief 


section introductions are for orientation only. 


Bits and bytes 


This section discusses the relationships between bit values and their 
position within a byte. The following are some rules of thumb 


regarding the 65C02 and 6502: 


oO A bit is a binary digit; it can be either a 0 ora 1. 


O A bit can be used to represent any two-way choice. Some choices 
that a bit can represent in the Apple Ile are listed in Table E-1. 


Table E-1 

What a bit can represent 

Context Representing O= 
Binary number Place value 0 
Logic Condition False 
Any switch Position Off 
Any switch Position Clear* 
Serial transfer Beginning Start 


l= 
1 x that power 
of 2 

True 

On 

Set 


Carrier (no 
information 
yet) 


9 
® 
ie] 
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Table E-2 
Values represented 
by a nibble 
Binary Hex 
0000 $00 
0001 $01 
0010 $02 
0011 $03 
0100 $04 
0101 $05 
0110 $06 
0111 $07 
1000 $08 
1001 $09 
1010 $0A 
1011 $0B 
1100 $0C 
1101 $0D 
1110 $0E 
1111 $OF 


Table E-1 (continued) 
What a bit can represent 


Context Representing O= l= 

Serial transfer Data 0 value 1 value 

Serial transfer Parity SPACE MARK 

Serial transfer End Stop bit(s) 

Serial transfer Communication BREAK Carrier 
state 

P reg. bit N Neg. result? No Yes 

P reg. bit V Overflow? No Yes 

P reg. bit B BRK command? No Yes 

P reg. bit D Decimal mode? No Yes 

P reg. bit I IRQ interrupts Enabled Disabled 

(masked out) 
P reg. bit Z Zero result? No Yes 
P reg. bit C Carry required? No Yes 


* Sometimes ambiguously termed reset 


QO Bits can also be combined in groups of any size to represent 
numbers. Most of the commonly used sizes are multiples of four 
bits. 


O Four bits are a nibble (sometimes spelled nybble). 


O One nibble can represent any of 16 values. Each of these values is 
assigned a number from 0 through 9 and (because our decimal 
system has only 10 of the 16 digits we need) A through F. 


0 Eight bits (two nibbles) make a byte (Figure E-1 and Table E-2). 


O One byte can represent any of 16 x 16 (or 256) values. The value 
can be specified by exactly two hexadecimal digits. 


High Nibble Low Nibble 








MSB LSB 
7 6 5 4 3 2 1 


$80 $40 $20 $10 $08 $04 $02 $01 
128 64 32 16 8 4 2 1 


Figure E-1 
Bits, nibbles, and bytes 


Hexadecimal 
Decimal 


Bits and bytes 237 


0 Bits within a byte are numbered from bit 0 on the right to bit 7 on 
the left. 


O The bit number is the same as the power of two that it represents, 
in a manner completely analogous to the digits in a decimal 
number. 


0 One memory position in the Apple Ile contains one eight-bit 
byte of data. 


CO How byte values are interpreted depends on whether the byte is 
an instruction in a language, part or all of an address, an ASCII 
code, or some other form of data. Tables E-6 through E-13 list 
some of the ways bytes are commonly interpreted. 


O Two bytes make a word. The 16 bits of a word can represent any 
one of 256 x 256 (or 65,536) different values. 


0 The 65C02 uses a 16-bit word to represent memory locations. It 
can therefore distinguish among 65,536 (64K) locations at any 
given time. 


Oo A memory location is one byte of a 256-byte page. The low-order 
byte of an address specifies this byte. The high-order byte 
specifies the memory page the byte is on. 


Hexadecimal and decimal 


Use Table E-3 for conversion of hexadecimal and decimal 
numbers. 


Table E-3 
Hexadecimal/decimal conversion 


Digit $x000 $0x00 $00x0 $000x 


61440 3840 240 15 
57344 3584 224 14 
53248 3328 208 13 
49152 3072 192 12 
45056 2816 176 11 


40960 2560 160 10 
36864 2304 144 
32768 2048 128 
28672 1792 112 
24576 1536 96 
20480 1280 80 
16384 1024 64 
12288 768 48 

8192 512 32 

4096 256 16 


PNWAUANBMOS> WOU MH 
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To convert a hexadecimal number to a decimal number, find the 
decimal numbers corresponding to the positions of each 
hexadecimal digit. Write them down and add them up. 


For example: 


$3C = ? $FD47 = ? 

$30 = 48 $FOOO = 61440. 
$oc = 12 $ DOO = 3328 
——<—<—= $ 40 = 64 
$3C = 60 $ 7= 7 


$FD47 = 64839 


To convert a decimal number to hexadecimal, subtract from the 
decimal number the largest decimal entry in the table that is less 
than the number. Write down the hexadecimal digit (noting its 
place value) also. Now subtract the largest decimal number in the 
table that is less than the decimal remainder, and write down the 
next hexadecimal digit. Continue until you have zero left. Add up 


the hexadecimal numbers. 


For example: 


16215 = $ ? 

16215 - 12288 = 3927 12288 = $7000 

3927 - 3840 = 87 3840 = $ FOO 
Md 80 = 7 80 = $ 50 


7 7a F 


16215 = S$7F57 


Hexadecimal and negative decimal 


If a number is larger than decimal 32,767, Applesoft BASIC allows 
and Integer BASIC requires that you use the negative-decimal 
equivalent of the number. Table E-4 is set up to make it easy for you 
to convert a hexadecimal number directly to a negative decimal 
number. 
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Table E-4 
Hexadecimal to negative decimal conversion 


Digit $x000 $$0x00 $$00x0 $$000x 


F 0 0 0 =] 
E —4096 -256 -16 -2 
D -8192 -512 32 3 
c -12288 -768 -48 wh 
B -16384 -1024 -64 5 
A -20480  -1280 -80 -6 
9 -24576  -1536 ~96 7 
8 -~28672  -1792 =412 -8 
7 -2048 ~128 -9 
6 —2304 -144 18 
p: -2560 -160 —11 
4 -2816 =176 “12 
3 3072 -192 -13 
2 -3328 -208 -14 
1 3584 224 -15 
0 -3840 -240 -16 


To perform this conversion, write down the four decimal number: 
corresponding to the four hexadecimal digits (zeros included). 
Then add their values. The resulting number is the desired negativ 
decimal number. 


For example: 


$CO10 = - ? 

$c000: -12288 
$ 000: - 3840 
$ 10: - 224 
§ Of 16 
$c010 -16368 


To convert a negative-decimal number to a positive decimal 
number, add it to 65,536. (This addition ends up looking like 
subtraction.) 


For example: 


-151 = +? 
65536 + (-151) = 65536 - 151 = 65385 


To convert a negative-decimal number to a hexadecimal number, 
first convert it to a positive decimal number, then use Table E-3. 
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Bits in Data Byte 





Dots on Graphics Screen 


Figure E-2 
Bit ordering in graphics displays 


Graphics bits and pieces 


Table E-5 is a quick guide to the hexadecimal values corresponding 
to seven-bit high-resolution patterns on the display screen. Since 
the bits are displayed in reverse order, it takes some:calculation to 
determine these values. Table E-5 should make it easy. 


Table E-5 


Hexadecimal values for high-resolution dot patterns 


Bit pattern 


x0000000 
x0000001 
x0000010 
x0000011 
x0000100 
x0000101 
x0000110 
x0000111 
x0001000 
x0001001 
x0001010 
x0001011 
x0001100 
x0001101 
x0001110 
x0001111 
x0010000 
x0010001 
x0010010 
x0010011 
x0010100 
x0010101 
x0010110 
x0010111 
x0011000 
x0011001 
x0011010 
x0011011 
x0011100 
x0011101 
x0011110 
x0011111 


x=0 


$00 
$40 
$20 
$60 
$10 
$50 
$30 
$70 
$08 
$48 
$28 
$68 
$18 
$58 
$38 
$78 
$04 
$44 
$24 
$64 
$14 
$54 
$34 
$74 
$0C 
$4C 
$2C 
$6C 
$1C 
$5C 
$3C 
$7C 


x=1 


$80 
$CO 
$A0 
$EO 
$90 
$D0 
$BO 
$FO 
$88 
$C8 
$A8 
$E8 
$98 
$D8 
$B8 
$F8 
$84 
$C4 
$A4 
$E4 
$94 
$D4 
$B4 
$F4 
$8C 
$CC 
$AC 
$EC 
$9C 
$DC 
$BC 
$FC 


Bit pattern 


x0100000 
x0100001 
x0100010 
x0100011 
x0100100 
x0100101 
x0100110 
x0100111 
x0101000 
x0101001 
x0101010 
x0101011 
x0101100 
x0101101 
x0101110 
x0101111 
x0110000 
x0110001 
x0110010 
x0110011 
x0110100 
x0110101 
x0110110 
x0110111 
x0111000 
x0111001 
x0111010 
x0111011 
x0111100 
x0111101 
x0111110 
x0111111 


Graphics bits and pieces 


x=0 


$02 
$42 
$22 
$62 
$12 
$52 
$32 
$72 
SOA 
$4A 
$2A 
$6A 
$1A 
$5A 
$3A 
$7A 
$06 
$46 
$26 
$66 
$16 
$56 
$36 
$76 
$0E 
$4E 
$2E 
$6E 
$1E 
$5E 
$3E 
$7E 


$E2 
$92 
$D2 
$B2 
$F2 
$8A 
$CA 
$AA 
$EA 
$9A 
$DA 
$BA 
$FA 
$86 
$C6 
$A6 
$E6 
$96 
$D6 
$B6 
$F6 
$8E 
$CE 
$AE 
$EE 
$9E 
$DE 
$BE 
$FE 
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The x represents bit 7. Zeros represent bits that are off; ones, bits 
that are on. Use the first hexadecimal value if bit 7 is to be off, and 
the second if it is to be on. 


For example, to get bit pattern 00101110, use $3A; for 10101110, 
use $BA. 


Table E-5 (continued) 
Hexadecimal values for high-resolution dot patterns 


Bit pattern x=0 x=1 Bit pattern x=0 x=1 
x1000000 $01 $81 x1100000 $03 $83 
x1000001 $41 $C1 x1100001 $43 $C3 
x1000010 $21 $Al x1100010 $23 $A3 
x1000011 $61 $E1 x1100011 $63 $E3 
x1000100 $11 $91 x1100100 $13 $93 
x1000101 $51 $D1 x1100101 $53 $D3 
x1000110 $31 $B1 x1100110 $33 $B3 
x1000111 $71 $F1 x1100111 $73 $F3 
x1001000 $09 $89 x1101000 $0B $8B 
x1001001 $49 $c9 x1101001 $4B $CB 
x1001010 $29 $A9 x1101010 $2B $AB 
x1001011 $69 $E9 x1101011 $6B $EB 
x1001100 $19 $99 x1101100 $1B $9B 
x1001101 $59 $D9 x1101101 $5B $DB 
x1001110 $39 $B9 x1101110 $3B $BB 
x1001111 $79 $F9 x1101111 $7B $FB 
x1010000 $05 $85 x1110000 $07 $87 
x1010001 $45 $C5 x1110001 $47 $C7 
x1010010 $25 $A5 x1110010 $27 $A7 
x1010011 $65 $E5 x1110011 $67 $E7 
x1010100 $15 $95 x1110100 $17 $97 
x1010101 $55 $D5 x1110101 $57 $D7 
x1010110 $35 $B5 x1110110 $37 $B7 
x1010111 $75 $FS x1110111 $77 $F7 
x1011000 $0D $8D x1111000 $OF $8F 
x1011001 $4D $CD x1111001 $4F $CF 
x1011010 $2D $AD x1111010 $2F $AF 
x1011011 $6D $ED x1111011 $6F $EF 
x1011100 $1D $9D x1111100 $1F $9F 
x1011101 $5D $DD x1111101 $5F $DF 
x1011110 $3D $BD x1111110 $3F $BF 
x1011111 $7D $FD x1111111 $7F $FF 


Appendix E: Conversion Tables 


Tne MouseText characters are 
shown in Table E-8. 


Eight-bit code conversions 


Tables E-5 through E-12 show the entire ASCII character set twice: 
once with the high bit off, and once with it on. Here is how to 
interpret these tables. 


O The Binary column has the eight-bit code for each ASCII 
character. 


O The first 128 ASCII entries represent seven-bit ASCII codes plus a 
high-order bit of 0 (SPACE parity or Pascal)—for example, 
010010000 for the letter H. 


O The last 128 ASCII entries (from 128 through 255) represent 
seven-bit ASCII codes plus a high-order bit of 1 (MARK parity or 
BASIC)—for example, 11001000 for the letter H. 


O A transmitted or received ASCII character will take whichever 
form is appropriate if odd or even parity is selected—for 
example, 11001000 for an odd-parity H, 01001000 for an even- 
parity H. 


O The ASCII Char column gives the ASCII character name. 


O The Interpretation column spells out the meaning of special 
symbols and abbreviations, where necessary. 


O The What to Type column indicates what keystrokes generate the 
ASCII character (where it is not obvious). 


The columns marked Priand AH indicate what displayed character 
results from each code when using the primary or alternate display 
character set, respectively. Boldface is used for inverse characters; 
italic is used for flashing characters. 


Note that the values $40 through $5F (and $CO through $DF) in the 
alternate character set are displayed as MouseText characters if 
MouseText is turned on. 


“+ Note: The primary and alternate displayed character sets in 
Tables E-6 through E-13 are the result of firmware mapping. 
The character generator ROM actually contains only one 
character set. The firmware mapping procedure is described in 
the section “Inverse and Flashing Text” in Chapter 3. 
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Table E-6 


Control characters, high bit off 


Binary 


0000000 
0000001 
0000010 
0000011 
0000100 
0000101 
0000110 
0000111 
0001000 


0001001 
0001010 
0001011 


0001100 
0001101 


0001110 
0001111 
0010000 
0010001 
0010010 
0010011 
0010100 
0010101 


0010110 
0010111 
0011000 
0011001 
0011010 
0011011 


0011100 
0011101 
0011110 
0011111 
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Dec 


ONAN AKRWDN FE © 


10 
11 


12 
13 


14 
15 
16 
17 
18 
19 
20 
21 


22 
23 
24 
25 
26 
27 


28 
29 
30 
31 
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Hex 


$00 
$01 
$02 
$03 
$04 
$05 
$06 
$07 
$08 


$09 
$0A 
$0B 


$0C 
$0D 


$0E 
$0F 
$10 
$11 
$12 
$13 
$14 
$15 


$16 
$17 
$18 
$19 
$1A 
$1B 


$1C 
$1D 
$1E 
$1F 


ASCll char Interpretation 


NUL 
SOH 
STX 

ETX 

EOT 
ENQ 
ACK 
BEL 

BS 


HT 
LF 
VT 


FF 
CR 


SO 
SI 
DLE 
DCl1 
DC2 
DC3 
DC4 
NAK 


SYN 
ETB 
CAN 
EM 
SUB 
ESC 


FS 
GS 
RS 
US 


Blank (null) 
Start of header 
Start of text 
End of text 
End of transm 
Enquiry 
Acknowledge 
Bell 
Backspace 


Horizontal tab 
Line feed 
Vertical tab 


Form feed 
Carriage return 


Shift out 

Shift in 

Data link escape 
Device control 1 
Device control 2 
Device control 3 
Device control 4 
Neg. acknowledge 


Synchronization 
End of text blk. 
Cancel 

End of medium 
Substitute 
Escape 


File separator 
Group separator 
Record separator 
Unit separator 


What to type 


Control-@ 
Control-A . 
Control-B 
Control-C 
Control-D 
Control-E 
Control-F 
Control-G 
Control-H 


or Left Arrow 


Control-I 
or Tab 
Control-J 


or Down Arrow 


Control-K 
or Up Arrow 
Control-L 
Control-M 
or Return 
Control-N 
Control-O 
Control-P 
Control-Q 
Control-R 
Control-S 
Control-T 
Control-U 


or Right Arrow 


Control-V 
Control-W 
Control-X 
Control-Y 
Control-Z 
Control-[ 
or Escape 
Control-\ 
Control-] 
Control-A 
Control-_ 


7 4 ~~ MOammMyAwmPe | 2? 


NHM <4 GHYBOVOZ zm 


— 


> 


Alt 


7 =~ = TAMMOADP EO 


TNHH GS GHEAPOVOZ zm 
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Table E-7 


Special characters, high bit off 


Binary 


ASCll char Interpretation 


0100000 
0100001 
0100010 
0100011 
0100100 
0100101 
0100110 
0100111 
0101000 
0101001 
0101010 
0101011 
0101100 
0101101 
0101110 
0101111 
0110000 
0110001 
0110010 
0110011 
0110100 
0110101 
0110110 
0110111 
0111000 
0111001 
0111010 
0111011 
0111100 
0111101 
0111110 
0111111 


Dec 


Hex 


$20 
$21 
$22 
$23 
$24 
$25 
$26 
$27 
$28 
$29 
$2A 
$2B 
$2C 
$2D 
$2E 
$2F 
$30 
$31 
$32 
$33 
$34 
$35 
$36 
$37 
$38 
$39 
$3A 
$3B 
$3C 
$3D 
$3E 
$3F 


SP 
! 


*VY~ NAN - SO # 


+ 


"OMAN AMNAWNH O™* 


SANE Ie WS 


Space 


Apostrophe 


Comma 
Hyphen 
Period 


What to type Pri 


Space bar 


CSN eS ye 


+ 


OMNAWMPPWNEO* 


wvyeawe 
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Alt 


“~V~ BLP = 


+ 


"OO RNAMURPWNE O™* 


wv dra‘ 
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Table E-8 


Uppercase characters, high bit off 


Binary 


1000000 
1000001 
1000010 
1000011 
1000100 
1000101 
1000110 
1000111 
1001000 
1001001 
1001010 
1001011 
1001100 
1001101 
1001110 
1001111 
1010000 
1010001 
1010010 
1010011 
1010100 
1010101 
1010110 
1010111 
1011000 
1011001 
1011010 
1011011 
1011100 
1011101 
1011110 
1011111 
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Dec 


64 
65 
66 
67 
68 
69 
70 
71 
72 
73 
74 
75 
76 
77 
78 
79 
80 
81 
82 
83 
84 
85 
86 
87 


89 
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$40 
$41 
$42 
$43 
$44 
$45 
$46 
$47 
$48 
$49 
$4A 
$4B 
$4C 
$4D 
$4E 
$4F 
$50 
$51 
$52 
$53 
$54 
$55 
$56 
$57 
$58 
$59 
$5A 
$5B 
$5C 
$5D 
$5E 
$5F 


ASCll char Interpretation 


PTH KTNKK AS CHYAROVOZEMAUM“TOAMMOIOWPE 


Opening bracket 
Reverse slant 
Closing bracket 
Caret 

Underline 


uv 
= 


PK TNR AESGHNVDROVOZSRSATVWAADHASOADAO 


> 


lda<e: TINY OR, 


Bt 


TL aFl 1®@ URI I ae 


Table E-9 
Lowercase characters. high bit off 


Binary Dec Hex ASCll char Interpretation What to type Pri Alt 
1100000 96 $60 % Grave accent ¥ 
1100001 97 $61 a ! a 
1100010 98 $62 b * b 
1100011 99 $63 c # c 
1100100 100 $64 d $ d 
1100101 101 $65 e % e 
1100110 102 $66 f & f 
1100111 103 $67 g : g 
1101000 104 $68 h C h 
1101001 105 $69 i ) i 
1101010 106 $6A j - j 
1101011 107 $6B k + k 
1101100 108 $6C 1 1 
1101101 109 $6D m - m 
1101110 110 $6E n : n 
1101111 111 $6F fo) / o 
1110000 112 $70 p O p 
1110001 113 $71 q 1 q 
1110010 114 $72 r 2 r 
1110011 115 $73 s 3 Ss 
1110100 116 $74 t 4 t 
1110101 117 $75 u 5 u 
1110110 118 $76 Vv 6 Vv 
1110111 119 $77 w 7 w 
1111000 120 $78 x 8 x 
1111001 121 $79 y 9 y 
1111010 122 $7A z : Z 
1111011 123 $7B { Opening brace ; { 
1111100 124 $7C | Vertical line < | 
1111101 125 $7D } Closing brace = } 
1111110 126 $7E \A Overline (tilde) > ~ 
1111111 127 $7F DEL Delete/rubout ? DEL 
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Table E-10 


Control characters, high bit on 


Binary 


10000000 
10000001 
10000010 
10000011 
10000100 
10000101 
10000110 
10000111 
10001000 


10001001 
10001010 
10001011 


10001100 
10001101 


10001110 
10001111 
10010000 
10010001 
10010010 
10010011 
10010100 
10010101 


10010110 
10010111 
10011000 
10011001 
10011010 
10011011 


10011100 
10011101 
10011110 
10011111 
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Dec 


128 
129 
130 
131 
132 
133 
134 
135 
136 


137 
138 
139 


140 
141 


142 
143 
144 
145 
146 
147 


149 


150 
151 
152 
153 
154 
155 


156 
157 
158 
159 
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Hex 


$80 
$81 
$82 
$83 
$84 
$85 
$86 
$87 
$88 


$89 


$8A 


$8B 


$8C 
$8D 


$8E 
$8F 
$90 
$91 
$92 
$93 
$94 
$95 


$96 
$97 
$98 
$99 
$9A 
$9B 


$9C 
$9D 
$9E 
$9F 


ASCll char Interpretation 


NUL 
SOH 
STX 

ETX 
EOT 
ENQ 
ACK 
BEL 

BS 


HT 
LF 
VT 


FF 
CR 


SO 
SI 
DLE 
DCi1 
DC2 
DC3 
DC4 
NAK 


SYN 
ETB 
CAN 
EM 
SUB 
ESC 


FS 
GS 
RS 
US 


Blank (null) 
Start of header 
Start of text 
End of text 
End of transm. 
Enquiry 
Acknowledge 
Bell 
Backspace 


Horizontal tab 
Line feed 
Vertical tab 


Form feed 
Carriage return 


Shift out 

Shift in 

Data link escape 
Device control 1 
Device control 2 
Device control 3 
Device control 4 
Neg. acknowledge 


Synchronization 
End of text blk. 
Cancel 

End of medium 
Substitute 
Escape 


File separator 
Group separator 
Record separator 
Unit separator 


What to type 


Control-@ 
Control-A 
Control-B 
Control-C 
Control-D 
Control-E 
Control-F 
Control-G 
Control-H 
or Left Arrow 
Control-I 

or Tab 
Control-J 

or Down Arrow 
Control-K 
or Up Arrow 
Control-L 
Control-M 
or Return 
Control-N 
Control-O 
Control-P 
Control-Q 
Control-R 
Control-S 
Control-T 
Control-U 
or Right Arrow 
Control-V 
Control-W 
Control-X 
Control-Y 
Control-Z 
Control-[ 

or Escape 
Control-\ 
Control-] 
Control-A 
Control-_ 


TODMOOAW?> ®@ 2 


— 


el 


GCHYOROVOZ ZH KR 


“NK Md < 


Alt 


TOAROOWP?PE 


HH 


ee 


Az 


“~MH Mee CHe Re woe -2F 


— 


Table E-11 


Special characters, high bit on 


Binary 


10100000 
10100001 
10100010 
10100011 
10100100 
10100101 
10100110 
10100111 
10101000 
10101001 
10101010 
10101011 
10101100 
10101101 
10101110 
10101111 
10110000 
10110001 
10110010 
10110011 
10110100 
10110101 
10110110 
10110111 
10111000 
10111001 
10111010 
10111011 
10111100 
10111101 
10111110 
10111111 


Dec 


160 
161 
162 
163 
164 
165 
166 
167 
168 
169 
170 
171 
172 
173 
174 


Hex 


$A0 
$Al1 
$A2 
$A3 
$A4 
$A5 
$A6 
$A7 
$A8 
$A9 
$AA 
$AB 
$AC 
$AD 
$AE 
$AF 
$BO 
$B1 
$B2 
$B3 
$B4 
$B5 
$B6 
$B7 
$B8 
$B9 
$BA 
$BB 
$BC 
$BD 
$BE 
$BF 


ASCll char _ Interpretation 


SP 


OMAN AWN KRWNH O™’ 


“vv IAT 


Space 


Apostrophe 


Comma 
Hyphen 
Period 


What to type Pri 


Space bar 


*YN - BLK * 


+ 


WOMANNAUWKRWNFH O™'* 


SY TT Att 


Eight-bit code conversions 


Alt 


WOMNNADUNRWNeH O™' 


i am | 2 cc 
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Table E-12 


Uppercase characters, high bit on 


Binary 


11000000 
11000001 
11000010 
11000011 
11000100 
11000101 
11000110 
11000111 
11001000 
11001001 
11001010 
11001011 
11001100 
11001101 
11001110 
11001111 
11010000 
11010001 
11010010 
11010011 
11010100 
11010101 
11010110 
11010111 
11011000 
11011001 
11011010 
11011011 
11011100 
11011101 
11011110 
11011111 
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Dec 


192 
193 
194 
195 
196 
197 
198 
199 
200 
201 
202 
203 
204 
205 
206 
207 
208 


210 
211 
212 
213 
214 
215 
216 
217 
218 
219 
220 
221 
222 
223 


Appendix E: Conversion Tables 


Hex 


$co 
$C1 
$C2 
$C3 
$C4 
$C5 
$C6 
$C7 
$Cc8 
$C9 
$CA 
$CB 
$CC 
$CD 
$CE 
$CF 
$D0 
$D1 
$D2 
$D3 
$D4 
$D5 
$D6 
$D7 
$D8 
$D9 
$DA 
$DB 
$DC 
$DD 
$DE 
$DF 


ASCil char Interpretation 


PT-"TNK MES CHYAOVOZZEMATM“*TOAMMIODPO 


Opening bracket 
Reverse slant 
Closing bracket 
Caret 

Underline 


im] 
= 


PTH KTINKM EK CHYAROVOZZMAUM“TOAMMOOWPS 


PM RKT-NKKASCHVAOVOZEMATMKBAAMMHOOWPS 


= 


Table E-13 


Lowercase characters, high bit on 


Binary 


11100000 
11100001 
11100010 
11100011 
11100100 
11100101 
11100110 
11100111 
11101000 
11101001 
11101010 
11101011 
11101100 
11101101 
11101110 
11101111 
11110000 
11110001 
11110010 
11110011 
11110100 
11110101 
11110110 
11110111 
11111000 
11111001 
11111010 
11111011 
11111100 
11111101 
11111110 
11111111 


Dec 


224 
225 
226 
227 
228 
229 
230 
231 
232 
233 
234 
235 
236 
237 
238 
239 
240 
241 
242 
243 
244 
245 
246 
247 


249 
250 
251 
252 
253 
254 
255 


Hex 


$EO 
$E1 
$E2 
$E3 
$E4 
$E5 
$E6 
$E7 
$E8 
$E9 
$EA 
$EB 
$EC 
$ED 
$EE 
$EF 
$FO 
$F1 
$F2 
$F3 
$F4 
$F5 
$F6 
$F7 
$F8 
$F9 
$FA 
$FB 
$FC 
$FD 
$FE 
$FF 


ASClil char Interpretation 


‘ 


Grave accent 


Opening brace 
Vertical line 
Closing brace 
Overline (tilde) 
DEL Delete/rubout 


Tr ~-TNNM KH AES ET BMADADOB RTH Two AAS 


What to type Pri Alt 
a a 
b b 
c c 
d d 
e e 
f f 
g g 
h h 
i i 
j j 
k k 
1 1 
m m 
n n 
fo) ro) 
p p 
q q 
r r 
S s 
t t 
u u 
Vv Vv 
Ww Ww 
x x 
y y 
z z 
{ { 

| | 
} } 
DELETE DEL DEL 


Eight-bit code conversions 
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Appendix F 


Frequently Used Tables 


This appendix contains copies of the tables you will need to refer to 
frequently; for example, ASCII codes and soft-switch location. The 
original table number is given in a footnote to the table. 


Table F-1° 
Keys and ASCIl codes 

Normal Control Shift Both 
Key Code Char Code Char Code Char Code Char 
Delete 7F DEL 7F DEL 7F DEL 7F DEL 
Left Arrow 08 BS 08 BS 08 BS 08 BS 
Tab 09 — HT 09 HT 09 HT 09 HT 
Down Arrow OA LF OA LF OA LF 0A LF 
Up Arrow OB VT OB VT OB VT OB VT 
Return OD CR 0D CR OD CR oD CR 
Right Arrow 15 NAK 15 NAK 15 NAK 15 NAK 
Escape 1B ESC 1B ESC 1B ESC 1B ESC 
Space 20 SP 20 SP 20 SP 20 SP 
tu 27 t 27 ' 22 " 22 " 
is 2C , 2C ; 3C < 3C < 
- 2D - 1F US 5F =, 1F US 
2 2E 2E : 3E > 3E > 
/? 2F / 2F / 3F ? 3F ? 
0) 30 0 30 0 29 ) 29 ) 
1! 31 1 31 1 21 ! 21 ! 
2@ 32 2 00 NUL 40 @ 00 NUL 
3# 33 3 33 3 23 # 23 # 
4$ 34 4 34 4 24 $ 24 $ 
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Table F-1 (continued)* 
Keys and ASCIl codes 


Key 


NK XSZ<CHYAOVOZEMATV TAMMY OWP 


* Table 2-2 


Note: Codes are shown here in hexadecimal, to find the decimal equivalents, refer to Table E-3. 


NM KX ES ETN BMOVOB Rs TKK Se rMAATS 


Control 
Char 

35 5 
1E RS 
37 7 
38 8 
39 9 
3B ; 
3D = 
1B ESC 
1C FS 
1D GS 
60 : 
01 SOH 
02 STX 
03 ETX 
04 EOT 
05 ENQ 
06 ACK 
07 BEL 
08 BS 
09 HT 
0A LF 
OB VT 
oc FF 
OD CR 
OE SO 
OF SI 
10 DLE 
11 DCc1 
12 DC2 
13 DC3 
14 DC4 
15 NAK 
16 SYN 
17 ETB 
18 CAN 
19 EM 
1A SUB 


Shift 


Code 


Char 


SS EB BOS 


NEM ZSCHYPAOVOZEZEMAGCMMOMMOAWP IWF 


Both 


Code 


Code 
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Char 


A *pas 


ESC 
FS 
GS 


SOH 
STX 

ETX 
EOT 
ENQ 
ACK 
BEL 


HT 
LF 
VT 


CR 
sO 
SI 
DLE 
DC1 
DC2 
DC3 
DC4 
NAK 
SYN 
ETB 
CAN 
EM 
SUB 
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Table F-2° 


Keyboard memory locations 


Location 


Hex 


Decimal Description 


$C000 49152 -16384 Keyboard data and strobe 
$C010 49168 -16368 Any-key-down flag and clear-strobe switch 


* Table 2-1 


Table F-3° 


Video display specifications 


Display modes 


Text capacity 
Character set 
Display formats 


Low-resolution 
graphics 


High-resolution 
graphics 


Double 
high-resolution 
graphics 


* Table 2-3 
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40-column text; map: Figure 2-3 

80-column text; map: Figure 2-4 

Low-resolution color graphics; map: Figure 2-8 
High-resolution color graphics; map: Figure 2-9 
Double high-res color graphics; map: Figure 2-10 


24 lines by 80 columns (character positions) 

96 ASCII characters (uppercase and lowercase) 
Normal, inverse, flashing, MouseText (Table 2-4) 
16 colors (Table 2-5), 40 horizontal by 48 
vertical; map: Figure 2-8 


6 colors (Table 2-6), 140 horizontal by 192 
vertical (restricted) 

Black-and-white: 280 horizontal by 192 vertical, 
map: Figure 2-9 


16 colors (Table 2-7), 140 horizontal by 192 
vertical (no restrictions) 

Black-and-white: 560 horizontal by 192 vertical; 
map: Figure 2-10 


Table F-4° 


Double high-resolution graphics colors 


Color abd 
Black $00 
Magenta a 
Brown $44 
Orange $4C 
Dark green $22 
Gray 1 $2A 
Green $66 
Yellow $6E 
Dark blue $11 
Purple $19 
Gray 2 $55 
Pink $5D 
Medium blue $33 
Light blue $3B 
Aqua $77 
White $7F 
* Table 2-7 

Table F-5° 


mb! 


$00 
$11 
$08 
$19 
$44 
$55 
$4C 
$5D 
$22 
$33 
$2A 
$3B 
$66 
$77 
$6E 
$7F 


Video display page locations 


Display 
Display mode page 


40-column text, 1 


low-resolution 2t 

graphics 

80-column text 1 
2+ 

High-resolution 1 

graphics 2 

Double high- 1¢ 

resolution 2+ 

graphics 

* Table 2-8 


ab2 


$00 
$22 
$11 
$33 
$08 
$2A 
$19 
$3B 
$44 
$66 
$55 
$77 
$4C 
$6E 
$5D 
$7F 


Lowest address 


Hex 


$0400 
$0800 


$0400 
$0800 


$2000 
$4000 


$2000 
$4000 


Dec 


1024 
2048 


1024 
2048 


8192 
16384 


8192 
16384 


mb3 


$00 
$44 
$22 
$66 
$11 
$55 
$33 
$77 
$08 
$4C 
$2A 
$6E 
$19 
$5D 
$3B 
$7F 


Repeated 
bit pattern 


0000 
0001 
0010 
0011 
0100 
0101 
0110 
0111 
1000 
1001 
1010 
1011 
1100 
1101 
1110 
1111 


Highest address 


Hex 


$07FF 
$OBFF 


$07FF 
$OBFF 


$3FFF 
$5FFF 


$3FFF 
$5FFF 


Dec 


2047 
3071 


2047 
3071 


16383 
24575 


16383 
24575 


+ This is not supported by firmware; for instructions on how to switch 
pages, refer to the section “Display Mode Switching” in Chapter 2. 
+ See the section “Double High-Resolution Graphics” in Chapter 2. 
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Table F-6° 
Display soft switches 


Name Action Hex Function 
ALTCHAR Ww $COOE = Off: display text using 
primary character set 
ALTCHAR Ww $COOF On: display text using 
alternate character set 
RDALTCHAR R7 $CO1E Read ALTCHAR switch 
(1 = on) 
80COL Ww $CO0C Off: display 40 columns 
80COL Ww $COOD ~— On: display 80 columns 
RD80COL R7 $CO1F Read 80COL switch (1 = on) 
80STORE W $C000 Off: cause PAGE2 on to 
select auxiliary RAM 
80STORE Ww $c001 On: allow PAGE2 to switch 
main RAM areas 
RD80STORE R7 $c018 Read 80STORE switch 
(1 = on) 
PAGE2 R/W $C054 Off: select Page 1 
PAGE2 R/W $C055 On: select Page 2 or, if 


80STORE on, Page 1 in 
auxiliary memory 


RDPAGE2 R7 $C01C Read PAGE2 switch (1 = on) 
TEXT R/W = $C050 Off: display graphics or, if 
MIXED on, mixed 

TEXT R/W $C051 On: display text 

RDTEXT R7 $CO1A Read TEXT switch (1 = on) 

MIXED R/W $C052 Off: display only text or only 
graphics 

MIXED R/W $C053 On: if TEXT off, display text 
and graphics 

RDMIXED R7 $C01B Read MIXED switch (1 = on). 

HIRES R/W = $C056 Off: if TEXT off, display low- 


resolution graphics 
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Table F-6° (continued) 
Display soft switches 


Name Action 
HIRES R/W 
RDHIRES R7 
IOUDIS W 
IOUDIS Ww 
RDIOUDIS R7 
DHIRES R/W 
DHIRES R/W 
RDDHIRES R7 
VBL R7 

* Table 2-9 


Hex 


$C057 


$C01D 
$CO7E 


$CO7F 


$CO7E 
$COS5E 


$COSF 


$CO7F 


$c019 


Function 


On: if TEXT off, display 
high-resolution or, if 
DHIRES on, double high- 
resolution graphics 


Read HIRES switch (1 = on) 


On: disable IOU access for 
addresses $C058 to $COS5F; 
enable access to DHIRES 
switcht 


Off: enable IOU access for 
addresses $C058 to $COSF; 
disable access to DHIRES 
switch 


Read IOUDIS switch (1 = off 


On: if IOUDIS on, turn on 
double high-resolution 


Off: if IOUDIS on, turn off 
double high resolution 


Read DHIRES switch 
d= on)t 


Vertical blanking 


+ The firmware normally leaves IOUDIS on. See also jf. 

+ Reading or writing any address in the range $CO70-$CO7F also triggers 
the paddle timer and resets VBLINT (Chapter 7). 

Note: W means write anything to the location, R means read the location, 

R/W means read or write, and R7 means read the location and check bit 7. 


Table F-7° 
Monitor firmware routines 


Locationo Name 


$C305 BASICIN 


$C307 BASICOUT 


Description 


With 80-column firmware active, 
displays solid, blinking cursor, 
accepts character from keyboard 


Displays a character on the screen; 
used when the 80-column firmware is 
active (Chapter 3) 
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Table F-7° (continued) 
Monitor firmware routines 


LocationO Name Description 

$FC9C CLREOL Clears to end of line from current 
cursor position 

$FC9OE CLEOLZ Clears to end of line using contents of 
Y register as cursor position 

$FC42 CLREOP Clears to bottom of window 

$F832 CLRSCR Clears the low-resolution screen 

$F836 CLRTOP Clears top 40 lines of low-resolution 
screen 

$FDED COUT Calls output routine whose address is 
stored in CSW (normally COUT1, 
Chapter 3). 

$FDFO COUT1 Displays a character on the screen 
(Chapter 3) 

$FD8E CROUT Generates a carriage return character 

$FD8B CROUT1 Clears to end of line, then generates a 
carriage return character 

$FD6A GETLN Displays the prompt character; 


accepts a string of characters by 
means of RDKEY 


$F819 HLINE Draws a horizontal line of blocks 

$FC58 HOME Clears the window and puts cursor in 
upper-left corner of window 

$FD1B KEYIN With 80-column firmware inactive, 


displays checkerboard cursor; 
accepts character from keyboard 


$F800 PLOT Plots a single low-resolution block on 
the screen 

$F94A PRBL2 Sends 1 to 256 blank spaces to the 
output device 

$FDDA PRBYTE Prints a hexadecimal byte 

$FF2D PRERR Sends ERR and Control-G to the 


output device 
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Table F-7° (continued) 
Monitor firmware routines 


LocationO Name Description 
$FDE3 PRHEX Prints 4 bits as a hexadecimal number 
$F941 PRNTAX Prints contents of A and X in 
hexadecimal 
$FDOC RDKEY Displays blinking cursor; goes to 
standard input routine, normally 
KEYIN or BASICIN 
$F871 SCRN Reads color value of a low-resolution 
block 
$F864 SETCOL Sets the color for plotting in low 
resolution 
$FC24 VTABZ Sets cursor vertical position 
$F828 VLINE Draws a vertical line of low-resolution 
blocks 
* Table 3-1 
Table F-8a° 
Control characters, 80-column firmware off 
Control ASCIl Apple lle 
character name name Action taken by COUTI 
Control-G BEL Bell Produces a 1000 Hz tone 
for 0.1 second 
Control-H BS Backspace Moves cursor position one 
space to the left; from left 
edge of window, moves to 
right end of line above 
Control-J LF Line feed Moves cursor position 
down to next line in 
window, scrolls if needed 
Control-M CR Return Moves cursor position to 


* Table 3-3a 
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left end of next line in 
window, scrolls if needed 
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Table F-8b* 


Control characters, 80-column firmware on 


Control 
character 


ASCII 
name 


Apple lle 
name 


Action taken by BASICOUT 


Control-G 


Control-H 


Control-J 


Control-Kt 


Control-Lt 


Control-M 


Control-Nt 


Control-Ot+ 


Control-Q} 
Control-R+ 
Control-S+ 


Control-Ut+ 


Control-V} 


Control-Wt 
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BEL 


BS 


LF 


VT 


FF 


CR 


SO 


SI 


DC1 
DC2 
DC3 


NAK 


SYN 


ETB 


Bell 


Backspace 


Line feed 


Clear EOS 


Home 
and clear 


Return 


Normal 


Inverse 


40-column 
80-column 


Stop-list 


Quit 


Scroll 


Scroll-up 


Produces a 1000 Hz tone 
for 0.1 second 


Moves cursor position one 
space to the left; from left 

edge of window, moves to 

right end of line above 


Moves cursor position 
down to next line in 
window; scrolls if needed 


Clears from cursor 
position to the end of the 
screen 


Moves cursor position to 
upper-left corner of 
window and clears window 


Moves cursor position to 
left end of next line in 
window, scrolls if needed 


Sets display format 
normal 


Sets display format 
inverse 


Sets display to 40-column 
Sets display to 80-column 


Stops listing characters on 
the display until another 
key is pressed 


Deactivates 80-column 
video firmware 


Scrolls the display down 
one line, leaving the 
cursor in the current 
position 


Scrolls the display up one 
line, leaving the cursor in 
the current position 


Table F-9° 


Text format control values 


Mask value 


Dec Hex Display format 


255 $FF 
and lowercase 


127 $7F 
and symbols 


63 $3F 


and lowercase 


* Table 3-5 


Note: These mask values apply 
only to the primary character set 


(see text). 


Normal, uppercase, 


Flashing, uppercase, 


Inverse, uppercase, 


Table F-8b* (continued) 
Control characters, 80-column firmware on 


Control 
character 


Control-X 


Control-Y+ 


Control-Zt 


Control-I[ 


Control-\t 


Control-]+ 


Control-_ 


* Table 3-3b 


ASCII 
name 


CAN 


EM 


SUB 


ESC 


FS 


GS 


US 


Apple Ile 
name 


Disable 
MouseText 


Home 


Clear line 


Enable 
MouseText 


Forward 
space 


Clear EOL 


Up 


t Doesn't work from the keyboard 
+ Only works from the keyboard. 


Table F-10° 


Escape codes 


Escape code 


Escape @ 


Escape A ora 


Escape B or b 


Function 


Action taken by BASICOUT 


Disables MouseText 
character display; use 
inverse uppercase 


Moves cursor position to 
upper-left corner of 
window (but doesn’t 
clear) 


Clears the line the cursor 
position is on 


Maps inverse 
uppercase characters to 
MouseText characters 


Moves cursor position one 
space to the right, from 
right edge of window, 
moves it to left end of line 
below 


Clears from the current 
cursor position to the end 
of the line (that is, to the 
right edge of the window) 


Moves cursor up a line, no 
scroll 


Clears window and homes cursor 
(places it in upper-left corner of 
screen), then exits from escape mode 


Moves cursor right one line; exits from 
escape mode 


Moves cursor left one line; exits from 
escape mode 
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Table F-10° (continued) 


Escape codes 


Escape code 


Escape C orc 
Escape D or d 
Escape E ore 
Escape F or f 
Escape I or i 


or Escape Up Arrow 


Escape J or j 
or Escape Left Arrow 


Escape K or k 

or Escape Right Arrow 
Escape M or m 

or Escape Down Arrow 


Escape 4 


Escape 8 


Escape Control-D 


Escape Control-E 


Escape Control-Q 


* Table 3-6 
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Function 


Moves cursor down one line; exits from 
escape mode 


Moves cursor up one line; exits from 
escape mode 


Clears to end of line; exits from escape 
mode 


Clears to bottom of window; exits from 
escape mode 


Moves the cursor up one line; 
remains in escape mode (see text) 


Moves the cursor left one space; 
remains in escape mode (see text) 


Moves the cursor right one 
space; remains in escape mode (see 
text) 


Moves the cursor down one 
line; remains in escape mode (see text) 


If 80-column firmware is active, switches 
to 40-column mode; sets links to 
BASICIN and BASICOUT; restores 
normal window size; exits from escape 
mode 


If 80-column firmware is active, switches 
to 80-column mode; sets links to 
BASICIN and BASICOUT; restores 
normal window size; exits from escape 
mode 


Disables control characters; only 
carriage return, line feed, BELL, and 
backspace have an effect when printed 


Reactivates control characters 


If 80-column firmware is active, 
deactivates 80-column firmware; sets 
links to KEYIN and COUT]; restores 
normal window size; exits from escape 
mode 


Table F-11° 
Pascal video control functions 


Control- Hex Function performed 

Eore $05 Turns cursor on (enables cursor display) 
Forf $06 Turns cursor off (disables cursor display) 
Gorg $07 Sounds bell (beeps) 

Horh $08 Moves cursor left one column. If cursor was at 


beginning of line, moves it to end of 
preceding line 


J or j $0A Moves cursor down one row; scrolls if needed 

Kork $0B Clears to end of screen 

Lorl $0C Clears screen; moves cursor to upper-left of 
screen 

Morm $0D Moves cursor to column 0 

Norn $0E Displays subsequent characters in normal 


video (Characters already on display are 
unaffected.) 


Ooro $0F Displays subsequent characters in inverse 
video (Characters already on display are 
unaffected.) 


Vorv $16 Scrolls screen up one line; clears bottom line 

W orw $17 Scrolls screen down one line; clears top line 

Yory $19 Moves cursor to upper-left (home) position 
on screen 

Zorz $1A Clears entire line that cursor is on 

| or \ $1C Moves cursor right one column, if at end of 


line, does Control-M 


dor] $1D Clears to end of the line the cursor is on, 
including current cursor position; does not 
move cursor 


A or 6 $1E GOTOxy: initiates a GOTOxy sequence; 
interprets the next two characters as x+32 and 
y+32, respectively 


$1F If not at top of screen, moves cursor up one 
line 


* Table 3-10 


Appendix F: Frequently Used Tables 263 


Table F-12* 
Bank select switches 


Name Action Hex Function 
R $C080 Read RAM; no write; use 
$D000 bank 2. 
RR $C081 Read ROM; write RAM; use 
$D000 bank 2. 
R $C082 Read ROM; no write; use 
$D000 bank 2. 
RR $C083 Read and write RAM; use 
$D000 bank 2. 
R $C088 Read RAM; no write; use 
$D000 bank 1. 
RR $C089 Read ROM; write RAM; use 
$D000 bank 1. 
R $CO8A Read ROM; no write; use 
$D000 bank 1. 
RR $CO8B Read and write RAM; use 
$D000 bank 1. 
RDBNK2 R7 $C011 Read whether $D000 
bank 2 (D or bank 1 (0). 
RDLCRAM R7 $C012 Reading RAM (1) or ROM (0). 
ALTZP Ww $C008 Off: use main bank, page 0 
and page 1. 
ALTZP Ww $C009 On: use auxiliary bank, page 0 
and page 1. 
RDALTZP R7 $C016 Read whether auxiliary (1) or 


main (0) bank. 


* Table 4-6 

Note: R means read the location, W means write anything to the location, 
R/W means read or write, and R7 means read the location and then check 
bit 7. 
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Table F-13* 


Auxiliary-memory select switches 


Name 


RAMRD 


RAMWRT 


80STORE 


PAGE2 


HIRES 


ALTZP 


* Table 4-7 


Function 


Read auxiliary memory 
Read main memory 
Read RAMRD switch 


Write auxiliary memory 
Write main memory 
Read RAMWRT switch 


On: access display page 
Off: use RAMRD, RAMWRT 
Read 80STORE switch 


Page 2 on (aux. memory) 
Page 2 off (main memory) 
Read PAGE2 switch 


On: access high-res pages 
Off: use RAMRD, RAMWRT 
Read HIRES switch 


Aux. stack & zero page 
Main stack & zero page 
Read ALTZP switch 


Hex 


$C003 
$C002 
$C013 


$C005 
$C004 
$C014 


$C001 
$C000 
$C018 


$C055 
$C054 
$CO1C 


$C057 
$C056 
$C01D 


$C009 
$C008 
$C016 


Location 

Decimal Notes 
49155 —16381 Write 
49154 -16382 Write 
49171 -16365 Read 
49157 -16379 Write 
49156 —16380 Write 
49172 -16354 Read 
49153 -16383 Write 
49152 -16384 Write 
49176 -16360 Read 
49237 -16299 tT 

49236 -16300 tT 

49180 —16356 Read 
49239 -16297 ¢ 

49238 -16298 } 

49181 -16355 Read 
49161 -16373 Write 
49160 ~16374 Write 
49174 -16352 Read 


t+ When 80STORE is on, the PAGE2 switch selects main or auxiliary display memory. 
$¢ When 80STORE is on, the HIRES switch enables you to use the PAGE2 switch to switch between the high- 
resolution Page 1 area in main memory or auxiliary memory. 


Table F-14* 

48K RAM transfer routines 

Name Action Hex Function 

AUXMOVE JSR $C311 Moves data blocks between 
main and auxiliary 
48K memory 

XFER JMP $C314 Transfers program control 


* Table 4-8 


between main and auxiliary 
48K memory 
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Table F-15* 
1/0 memory switches 


Name Function 


SLOTC3ROM Slot ROM at $C300 
Internal ROM at $C300 
Read SLOTC3ROM switch 


SLOTCXROM Slot ROM at $Cx00 
Internal ROM at $Cx00 
Read SLOTCXROM switch 


* Table 6-5 


Table F-16° 


Location 

Hex Decimal 

$COOB 49163 -16373 
$COOA 49162 -16374 
$C017 49175 -16361 
$C006 49159 -16377 
$C007 49158 -16378 
$C015 49173 -16363 


1/O routine offsets and registers under Pascal 1.1 


Address Offset for 


$CsOD Initialization 
On entry 
On exit 
$CsOE Read 
On entry 
On exit 


$CsOF Write 
On entry 
On exit 


$Cs10 Status 
On entry 
On exit 


* Table 6-7 
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X register 


$Cs 
Error code 


$Cs 
Error code 


$Cs 
Error code 


$Cs 
Error code 


Y register 


$s0 
(unchanged) 


$s0 
(unchanged) 


$s0 
(unchanged) 


$s0 
(changed) 


- Notes 


Write 
Write 
Read 


Write 
Write 
Read 


protocol 


A register 


(unchanged) 


Character read 


Char. to write 
(unchanged) 


Request © or 1) 
(unchanged) 
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Using an 80-Column Text Card 


This appendix explains how to use 80-column text cards with high- 
level languages. Information about using 80-column text cards with 
assembly-language programs through the Apple Ile Monitor 
firmware is found in Chapter 3 of this manual. The information in 
this appendix applies to the Apple Ile 80-Column Text Card and the 
Apple Ile Extended 80-Column Text Card. 


If you are using Applesoft, ProDOS, or DOS you can choose to 
leave the 80-column text card inactive after installing it. You will 
want to do this when running software that does not take advantage 
of the 80-column display capability. 


The startup procedure for displaying 80 columns of text on your 
Apple Ile depends on which operating system you plan to use. 
Starting up the system with Apple II Pascal or CP/M is very easy; the 
operating system does it for you. The procedures for starting up with 
ProDOS or DOS 3.3 are slightly more complicated, but not 
difficult. 


Starting up with Pascal or CP/M 


Pascal programmers don’t have to activate the text card because 
Pascal does it for them. If you use the Pascal language or the CP/M 
operating system, displaying 80 columns of text is automatic once 
you've installed the card. Simply start up your system with any 
Pascal or CP/M startup disk. 
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Refer to the operating system 
reference manual for your 
version of Apple Pascal for more 
information. 


“ CP/M: Control Program for Microprocessors is a trademark of 
Digital Research. To use the CP/M operating system with your 
Apple Ile, make sure the SOFTCARD by Microsoft or the 
Z-Engine by Advanced Logic Systems is correctly installed 
before you start up the computer. 


“ Coprocessor cards and interrupts: Some coprocessor cards that 
were designed for use in the Apple II Plus may not work with an 
Apple Ile without some modification. There could be problems 
if you want to use interrupts on the Apple Ile. If you are having 
problems with a coprocessor card, check with the card’s 
manufacturer for their recommendations. 


When using Apple II Pascal 1.1, you’ll probably want to run the 
program SETUP to make the Up Arrow and Down Arrow keys 
functional. SETUP is a self-documenting program on the Pascal disk 
APPLE3. Pascal versions 1.2 and later are already configured to use 
the Up Arrow and Down Arrow keys. 


Starting up with ProDOS or DOS 3.3 


ProDOS and DOS 3.3 both look for a startup program on the startup 
(boot) disk as soon as the operating system has been loaded and 
begins executing. If the operating system finds the program, named 
STARTUP on a ProDOS disk and usually HELLO on a DOS 3.3 disk, 
it will execute the program. 


You can write a customized startup program that will set up the 80- 
column text card in any state you need. Just be sure it is on your 
startup disk and has the startup filename. 


Here is a sample Applesoft startup program that works with both 
ProDOS and DOS 3.3: 


10 HOME:D$=CHRS (4) 
20 PRINT DS$;"PR#3" 
30 END 


You can do whatever you wish with the program from line 20 on. 
Note that the screen will have switched to 80-column text mode after 
line 20. 


“ By the way: If you arrange to have the card active 
automatically, you will still, of course, be able to switch 
into 40-column mode. 
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Original lle 


Using the GET Command 


The presence of an active 80-column text card in the Ile requires 
that BASIC programmers use some alternative to Applesoft’s INPUT 
command if their programs are to be userproof. Applesoft 
programmers should use either the GET command or the RDKEY 
or GETLN subroutines. 


This is because the escape sequences used to switch back and forth 
between modes or to deactivate the card sometimes make it 
necessary to accept escape sequences in INPUT mode when using an 
80-column card. Because the program accepts escape sequences 
typed from the keyboard, your program will not be userproof 
against accidental sequences typed in response to an INPUT 
command. 


To get around this problem, you can use the GET command 
instead. The program does not read escape sequences typed from 
the keyboard in response to a GET command. This means that your 
users can err in their responses without endangering the display. 


When to switch modes 
versus when to deactivate 


When using BASIC, deactivate the text card whenever a previous 
(BASIC) program has left the card active (eaving a solid cursor on 
the screen) or whenever you want to send output to a peripheral 
device. 


Switch back and forth between 40-column and 80-column displays 
for visual appeal. For full use of the control characters described 
later, your card must be active, although it can display in either 40- 
column or 80-column mode. 


Tabbing In Applesoft: You must switch to a 40-column display to 
use Applesoft comma tabbing or the HTAB command. 
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Display features with the text card 


With an active 80-column card you can issue BASIC and PRODOS 
commands in lowercase characters. You can also issue commands 
in lowercase from the keyboard, that is, in immediate mode. This is 
particularly convenient because REM statements and data within 
quotation marks remain in lowercase as they were typed. 


If you are using DOS 3.3, you must issue commands in uppercase 
whether or not your card is active. 


INVERSE, FLASH, NORMAL, HOME 


There are several commands you can give your computer from 
Applesoft BASIC to affect the appearance of text on the screen. All 
of these features are described in the Applesoft BASIC 
Programmer's Reference Manual. 


O INVERSE tells the computer to display black characters on a white 
background instead of the normal display of white characters on 
a black background. This command is normally only available 
for uppercase characters, but with an active 80-column text card 
it is available for uppercase and lowercase characters. 


O FLASH causes subsequently printed characters to blink quickly 
between inverse and normal characters. You can turn off the 
FLASH command by typing the NORMAL command. The FLASH 
command is normally available only with uppercase characters; 
it is not available at all while the card is active. 

0 NORMAL tells the computer to turn off the INVERSE or FLASH 
command and to display subsequently printed characters 
normally. It works the same way with the card active or inactive. 

O HOME clears the screen and returns the cursor to the upper-left 
corner of the screen. Both the NORMAL HOME and INVERSE 
HOME commands are available while the card is active, but 
INVERSE HOME works a little differently when the card is active. 


By the way; The FLASH and INVERSE commands can be used 
to highlight important screen messages within a BASIC 
program. 


+ 
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Important 


If you are using the FLASH command (which means the 80- 
column text card Is Inactive) and then type PR#3 to activate 
the card, the screen turns white as the cursor goes to the 
HOME position. Whatever you type appears In black characters 
on the white screen. If you list or run an Applesoft BASIC 
program, some of the characters will appear as MouseText 
characters, To avoid this, remember to use the NORMAL or 
INVERSE command before you exit the program. 


Tabbing with the original Apple Ile 


You cannot use conventional 40-column tabbing in BASIC with the 
original model Apple Ile with an 80-column display. You do not 
have to turn off your card, but you must switch out of 80-column 
mode to use the HTAB command or to use comma tabbing. 


When an original Apple Ile is displaying 80-column text, you 
should use the POKE 1403 command for horizontal tabbing in the 
right half of the screen instead of the HTAB command. 


Comma tabbing with the original Apple lle 


In BASIC you can use commas in PRINT statements to instruct the 
computer to display all or part of your output in columns. This is 
known as comma tabbing. You can use this method of tabbing as 
long as the screen is displaying 40 columns (that is, with the card 
inactive or after issuing the Escape 4 command to switch to 40- 
column mode). You cannot use this method of tabbing with an 80- 
column display. If you try to do so, characters will be placed in 
memory outside the screen area and may change programs or data 
in memory. 


HTAB and POKE 1403 


The VTAB (vertical tab) and HTAB (horizontal tab) statements can 
be used to place the cursor at a specific location on the screen 
before printing characters. The largest value you can use with the 
VTAB statement is 24; the largest for HTAB is 255. The VIAB 
command works just the same in an 80-column display as it does in 
a 40-column display. 
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On the original Apple Ile, the HTAB command causes the cursor to 
wrap around to the next line after it reaches the 40th column, so you 
cannot use this command to position the cursor in the last 40 
columns while the screen is displaying 80 columns. 


POKE 1403 is specifically designed to solve this problem. Using the 
POKE 1403 command allows you to tab horizontally across the 
extra 40 columns provided by the 80-column text card. 


If you want to tab past column 40 while the card is active and the 
screen is displaying 80 columns, use the following, where n is a 
number from 0 to 79: 


POKE 1403, n 


When you use the HTAB command, HTAB 1 places the cursor at the 
leftmost position on the screen. When you use the POKE 1403 
command, “POKE 1403,0” places the cursor at the leftmost 
position on the screen. 


Using control characters with the card 


Using BASIC with an active 80-column text card increases the 
number of functions you can perform with control characters. 
Originally control-character commands were so named because 
they were given from the keyboard by pressing the Control key in 
conjunction with another key. You can perform the same functions 
from your programs by using an equivalent control-character code. 
Commands based on these two-key combinations are called 
control-character commands even when they must be issued from 
a program. 


Control characters and their functions 


Table G-1 lists the control-character commands supported by 
BASIC with an 80-column card. The table includes the 
corresponding command code, its function, and whether a given 
command can be executed from the keyboard as well as from a 
program. 
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Table G-1 


Control characters, 80-column firmware on 


Control 
character 


Control-G 


Control-H 


Control-J 


Control-K* 


Control-L* 


Control-M 


Control-N* 


Control-O* 


Control-Q* 
Control-R* 
Control-St 


Control-U* 


Control-Vv* 


ASCIl 
name 


BEL 


BS 


LF 


VT 


CR 


SO 


SI 


DC1 


DC2 


DC3 


NAK 


SYN 


Apple lle 
name 


Bell 


Backspace 


Line feed 


Clear EOS 


Home 
and clear 


Return 


Normal 


Inverse 


40-column 
80-column 
Stop-list 
Quit 


Scroll 


Action taken by BASICOUT 


Produces a 1000 Hz tone 
for 0.1 second 


Moves cursor position one 
space to the left; from left 

edge of window, moves to 

right end of line above 


Moves cursor position 
down to next line in 
window; scrolls if needed 


Clears from cursor 
position to the end of the 
screen 


Moves cursor position to 
upper-left corner of 
window and clears window 


Moves cursor position to 
left end of next line in 
window, scrolls if needed 


Sets display format 
normal 


Sets display format 
inverse 


Sets display to 40-column 
Sets display to 80-column 


Stops listing characters on 
the display until another 
key is pressed 


Deactivates 80-column 
video firmware 


Scrolls the display down 
one line, leaving the 
cursor in the current 
position 
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Table G-1 (continued) 


Control characters, 80-column firmware on 


Control 
character 


Control-W* 


Control-X 


Control-Y* 


Control-Z* 


Control-[ 


Control-\* 


Control-]* 


Control-_ 


ASCII 
name 


ETB 


CAN 


EM 


SUB 


ESC 


FS 


GS 


US 


Apple lle 
name 


Scroll-up 


Disable 
MouseText 


Home 


Clear line 


Enable 
MouseText 


Forward 
space 


Clear EOL 


Up 


* Doesn't work from the keyboard 
+ Only works from the keyboard 
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Action taken by BASICOUT 


Scrolls the display up one 
line, leaving the cursor in 
the current position 


Disables MouseText 
character display; use 
inverse uppercase 


Moves cursor position to 
upper-left corner of 
window (but doesn’t 
clear) 


Clears the line the cursor 
position is on 


Maps inverse 
uppercase characters to 
MouseText characters 


Moves cursor position one 
space to the right, from 
right edge of window, 
moves it to left end of line 
below 


Clears from the current 
cursor position to the end 
of the line (that is, to the 
right edge of the window) 


Moves cursor up a line, no 
scroll 


See Chapter 3 in this manual for 
a description of control- 
character functions. 


How fo use control-character codes in programs 


To issue a control-character command from a program, use the 
ASCII decimal code that corresponds to the control character. (See 
Table G-1.) 


The following example shows how to use ASCII decimal codes in an 
Applesoft BASIC program. Type 


HOME [?] NEW 

10 PRINT CHR$(15): PRINT "MAKE HAY" 

20 PRINT CHR$(14): PRINT "WHILE THE SUN SHINES" 
RUN 


(CHR$ is the Applesoft BASIC command that signifies that a 
control-character function is to be performed.) 


You will get 


] NEW 

]10 PRINT CHR$(15): PRINT "MAKE HAY" 

]20 PRINT CHR$(14): PRINT "WHILE THE SUN SHINES" 
] RUN 


MAKE HAY 
WHILE THE SUN SHINES 
ja 


The ASCII decimal codes for inverse video (Control-O) and normal 
video (Control-N) are 15 and 14. When the PRINT statements in the 
example are executed, the display switches to inverse and prints 
MAKE HAY, then switches back to a normal display and prints 
WHILE THE SUN SHINES. 


A word of caution to Pascal programmers 


Avoid writing Control-U or Control-Q to the console from a Pascal 
program. Either one puts the system into a state that will eventually 
cause Pascal to crash. 


You can’t send control characters from the keyboard to the 80- 
column firmware when using Pascal. The only exceptions to this 
rule are Control-M (CR) and Control-G (BEL). 
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For more information about the 
installation and operation of the 
SSC, see the Super Serial Card 
manual. 


The Pascal 1.1 firmware protocol 
is described in Chapter 6. 
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Appendix H 


Programming With the 
Super Serial Card 


This appendix briefly tells how to use the Apple II Super Serial Card 
(SSC) from programs and how to find the SSC through software, and 
describes the commands supported by the SSC. 


The SCC is one of the most common serial interface cards used with 
the Apple Ile, and the Apple IIc’s serial ports operate very much 
like the Super Serial Card. This similarity should make it easier for 
you to write programs for both the Apple Ile and Apple IIc. 


Locating the card 


Locations $Cs05, $Cs07, $CsOB, and $CsO0C (where s is the number 
of the slot where the SSC is installed) contain the identification 
bytes for the Super Serial Card. The identification byte’s values are 


$Cs05—s- $38 
$Cs07 —s_- $18 
$CsOB = $01 
$CsOC = $31 


Operating modes 


The Super Serial Card has two main operating modes: printer mode 
and communications mode. There is nothing you can do from 
software to change from one mode to the other because they are set 
by the position of the jumper block. 


“ Note to software developers: If you are writing software that 
depends on the SSC being in a given operating mode, make 
sure that your documentation tells the user to set up the SSC in 
the proper way. 


In printer mode, the SSC is set to send data to a printer, local 
terminal, or other serial device. In communications mode, the SSC 
is set to operate with a modem. From communications mode, the 
SSC can enter a special mode called terminal mode. In terminal 
mode the Apple Ile acts like an unintelligent terminal. 


Operating commands 


For each of the operating modes, you can control many aspects of 
data transmission such as baud rate, data format, and line feed 
generation. 


Your program can change these aspects by sending control codes 
as commands to the card. All commands are preceded by a 
command character and followed by a carriage return character 


($0D). 


The command character is usually Control-I in printer mode and 
Control-A in communications mode and terminal mode. In the 
command examples in the following sections, Control-I is used 
unless the command being described is available only in 
communications mode or terminal mode. A carriage return 
character is represented by its ASCII symbol, CR. 


There are three types of command formats: 


oO A number, represented by n, followed by an uppercase letter 
with no space between the characters (for example, 4D to set data 
format 4). 


oO An uppercase letter by itself (for example, R to reset the SSC). 


© An uppercase letter followed by a space and then either E to 
enable or D to disable a feature (for example, L D to disable 
automatic insertion of line feed characters). 
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The allowable range of n is given in each command description that 
follows. 


The choice of enable or disable is indicated with E/D. The 
underscore character ( _ ) before the E/D in commands that allow 
enable/disable is to remind you that a space is required there. 


The SSC checks only numbers and the first letters of commands and 
options. (All such letters must be uppercase.) Further letters, which 
you can add to assist your memory, have no effect on the SSC. For 
example, XOFF Enable is the same as X E. The SSC ignores invalid 
commands. 


Important The spaces In command examples are there for clarity; 
generally you will not use spaces In a command string. Where a 
space is required In a command string, an underscore ( _ ) 
character will appear in the text as a reminder. 


The command character 


The normal command character is Control-I (ASCII $09) in printer 
mode, or Control-A (ASCII $01) in communications mode. If you 
want to change the command character from Control-I to Control- 
something else, send Control-I Control-something else. For 
example, to change the command character to Control-W, send 
Control-I Control-W. To change back, send Control-W Control-I. 
No return character is required after either of these commands. 


Here is how to do this in BASIC and Pascal: 
Applesoft BASIC: 

PRINT CHRS(9); "new command character" 
Pascal: 

WRITELN (CHR(9), 'new command character') ; 


You can send the command character itself through the SSC by 
sending it twice in a row: Control-I Control-I; no return character is 
required after this command. This special command allows you to 
transmit the command character without affecting the operation of 
the SSC, and without having to change to another command 
character and then back again later. 
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Baud rate, nB 


You can use this command to override the physical settings of 
switches SW1-1 through SW1-4 on the SSC. For example, to change 
the baud rate to 135, send Control-I 4B CR to the SSC. 


Table H-1 

Baud rate selections 

n_ SSC baud rate n SSC baud rate 

0 Use SW1-1 to SW1-4 8 1200 

1 50 9 1800 
Table H-2 4 10 2400 
Data format selections 3 109.92 (110) 11 3600 
n Data bits Stop bits 4 134.58 (135) 12 4800 

5 150 13 7200 

6 300 14 9600 

7 600 15 19200 


NAM COW ANI © 


Nw DN PRR eS 
* 


Data format, nD 


5 at You can override the settings of switch SW2-1 with this command. 
The table below shows how many data and stop bits correspond to 
each value of n. For example, Control-I 2D CR makes the SSC 
transmit each character in the form one start bit Galways 


NAW BROWN RF © 


* 1 with parity options 4 through 7 
t 11/2 with parity options 


0 through 3 
transmitted), six data bits, and one stop bit. 
Table H-3 
Parity selections 
n Parity to use Parity, nP 


You can use this command to set the parity that you want to use for 


0,2,4, None (default value) es se : : 
data transmission and reception. There are five parity options 


al available, described in Table H-3. 
1 Odd parity (odd total ° 
Anbar af cnes) For example, the command string Control-I 1P CR makes the SSC 
transmit and check for odd parity. Odd parity means that the high 
3 Even parity (even total _ bit of every character is 0 if there is an odd number of 1 bits in that 
number of ones) character, or 1 if there is an even number of 1 bits in the character, 
: es ras making the total number of 1 bits in the character always odd. This 
? te iy epee is an easy (but not foolproof) way to check data for transmission 
errors. Parity errors are recorded in a status byte. 
7 SPACE parity (parity bit 
always 0) 
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Table H-4 

Time delay selections 
n__ Time delay 

Q None 

1 32 milliseconds 

2 250 milliseconds 

(1/4 second) 

3  2seconds 
280 


Set time delay, nC, nL, and nF 


Some printers can’t keep up with the Apple IIe when they are doing 
certain operations. You may need to change default settings on the 
SSC to give a printer the time it needs. 


The nC command overrides the setting of switch SW2-2 on the SSC. 
That switch provides two choices: either no delay or a 250 
millisecond delay after the SSC sends a carriage return character. 


The nL command allows time after a line feed character for a printer 
platen to turn so that the paper is vertically positioned to receive the 
next line. 


The nF command allows time after a form feed character for the 
printer platen to move the paper form to the top of the next page 
(typically a longer time than a line feed). 


Consult the user manual for a given printer to find out how much 
time it takes to move its print head and platen so that you can 
determine an appropriate set of values for these three delays. The 
idea is to have at least enough time for the printer parts to move the 
required distance, but not so much time that overall printing speed 
is slowed down drastically. Many printers require no delays because 
they have a buffer built in to keep accepting characters even while 
they are doing form feeds and so on. 


A typical setup for a very slow printer would be Control-I 2C CR, 
Control-I 2L CR, Control-I 3F CR; that is, the SSC waits 250 
milliseconds after transmitting carriage returns, 250 milliseconds 
after transmitting line feeds, and 2 seconds after transmitting form 
feed characters. 


Echo characters to the screen, E_E/D 


For the Apple IIe, as for most computers, displaying (echoing) a 
character on the video screen during communications is a separate 
step from receiving it from the keyboard, though we tend to think if 
these as one step, as on a typewriter. For example, if you send 
Control-A E_D CR, the SSC does not forward incoming character: 
to the Apple Ile screen. This can be used to hide someone’s 
password entered at a terminal, or to avoid double display of 
characters. 


This command is used in communications mode only. 


Appendix H: Programming With the Super Serial Card 


Important 


Automatic carriage return, C 


Sending Control-I C CR to the SSC causes it to generate a carriage 
return character (ASCII CR) whenever the column count exceeds the 
current printer line-width limit. This command is used in printer 
mode only. 


Once this option is on, only clearing the high-order bit at 
location $578+s (where s is the slot the SSC Is in) can turn this 
option back off. This option is normally off. 


Automatic line feed, L_E/D 


You can use this command to have the SSC automatically generate 
and transmit a line feed character after each carriage return 
character. This overides the setting of switch SW2-5. For example, 
send Control-I L_E CR to your printer to print listings or double- 
spaced manuscripts for editing. 


Mask line feed in, M_E/D 


If you send Control-I M_E CR to the SSC, it will ignore any 
incoming line feed character that immediately follows a carriage 
return character. 


Reset card, R 


Sending Control-I R CR to the SSC has the same effect as sending a 

PR#0 and an IN#¥0 to a BASIC program and then resetting the SSC. 

This command cancels all previous commands to the SSC and puts 
the physical switch settings back into force. 
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Specify screen slot, S$ 


In communications mode, you can specify the slot number of the 
device where you want text or listings displayed with this command. 
(Normally this is slot 0, the Apple Ie video screen.) This allows 
chaining of the SSC to another card slot, such as an 80-column text 
card. For the firmware in the SSC to pass on information to the 
firmware in the other card, the other card must have an output entry 
point within its $Cs00 space; this is the case for all currently 
available 80-column cards for the Apple Ile. 


For example, let's say you have the SSC in slot 2 with a remote 
terminal connected to it, and an 80-column card in slot 3. 

Send Control-A 3S CR to cause the data from the remote terminal 
to be chained through the card in slot 3, so that it is displayed on 
the Apple Ile in 80-column format. (Not available in Pascal.) 


Translate lowercase characters, nT 


The Apple IIe Monitor translates all incoming lowercase characters 
into uppercase ones before sending them to the video screen or to a 
BASIC program. The nT command has four options, which are 
shown in Table H-5. 


Table H-5 
Lowercase character display. options 


n Action 


0 Change all lowercase characters to uppercase ones before 
passing them to a BASIC program or to the video screen. This 
is the way the Apple Ile monitor handles lowercase. 


1 _— Pass along all lowercase characters unchanged. The 
appearance of the lowercase characters on the Apple II screen 
is undefined (garbage). 


2 Display lowercase characters as uppercase inverse characters 
(that is, as black characters on a white background). 


3 Pass lowercase characters to programs unchanged, but display 
lowercase as uppercase, and uppercase as inverse uppercase 
(that is, as black characters on a white background). 
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Important 


Important 


Suppress control characters, Z 


If you issue the Z command described here, all further commands 
are ignored; this is useful if the data you are transmitting, such as 
graphics data, contains bit patterns that the SSC can mistake for 
control characters. 


Sending Control-I Z CR to the SSC prevents it from recognizing any 
further control characters (and hence commands) whether coming 
from the keyboard or contained in a stream of characters sent to the 
SSC. 


The only way to reinstate command recognition after the Z 
command is to either reinitialize the SSC, or clear the high-order 
bit at location $5F8+s (where s is the number of the slot in 
which the SSC Is installed). 


Find keyboard, F_E/D 
You can use this command to make the SSC ignore keyboard input. 


For example, you can include Control-I F_D CR in a program, 
followed by a routine that retrieves data through the SSC, followed 
by Control-I F_E CR to turn the keyboard back on. 


XOFF recognition, X_E/D 


Sending Control-I X_E CR to the SSC causes it to look for any KOFF 
($13) character coming from a device attached to the SSC, and to 
respond to it by halting transmission of characters until the SSC 
receives an XON ($11) from the device, signaling the SCC to 
continue transmission. In printer mode, this function is normally 
turned off. 


In printer mode, full-duplex communication may not work with 
XOFF recognition turned on, so be careful. 
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Tab in BASIC, T E/D 


In printer mode only, if you send Control-I T_E CR to the SSC, the 

BASIC horizontal position counter is left equal to the column count. 
All tabs work, including back-tabs. Tabs beyond column 40 require 

a POKE to location 36. Commas only work as far as column 40, and 

BASIC programs will be listed in 40-column format. 


Note that this use of tabbing is specific to the SSC—it doesn’t go 
through the 80-column firmware. 


Terminal mode 


From communications mode, the SSC can enter terminal mode 
and make the Apple Ile act like an unintelligent terminal. This is 
useful for connecting the Apple Ile to a computer timesharing 
service, or for conversing with another Apple II. 


Entering terminal mode, T 


Send Control-A T CR to enter terminal mode. This causes the 
Apple Ile to function as a full-duplex unintelligent terminal. You 
can use this command together with the Echo command to simulate 
the half-duplex terminal mode of the old Apple Il Communications 
Card. 


“ By the way: If you enter terminal mode and don’t see what you 
type echoed on the Apple video screen, probably the modem 
link has not yet been established, or you need to use the Echo 
Enable command (Control-A E_E CR). 


Transmitting a break, B 


Sending Control-A B CR causes the SSC to transmit a 233- 
millisecond break signal, recognized by most time-sharing systems 
as a signoff. 
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Special characters, $_E/D 


If you send Control-A S_D CR, the SSC will treat the Escape key like 
any other key. 


Quitting terminal mode, Q 
Send Control-A Q CR to the SSC to exit from terminal mode. 


SSC error codes 


The SSC uses I/O scratchpad address $678+s (s is the number of the 
slot that the SSC is in) to record status after a read operation. The 
firmware calls this byte STSBYTE. Table H-6 lists the bit definitions 
of this byte. 


Table H-6 

STSBYTE bit definitions 

Bit “1" means “0” means 

0 Parity error occurred No parity error occurred 

1 Framing error occurred No framing error occurred 
2 Overrun occurred No overrun occurred 

3 Carrier lost Carrier present 

5 Error occurred No error occurred 


The terms parity, framing error, and overrun are defined in the 
glossary. 


Bits 0, 1, and 2 are the same as the corresponding three bits of the 
ACIA Status Register of the SSC. Bit 3 indicates whether or not the 
Data Carrier Detect (DCD) signal went false at any time during the 
receive operation. Bit 5 is set if any of the other bits are set, as an 

overall error indicator. If bit 5 is the only bit set, an unrecognized 
command was detected. If all bits are 0, no error occurred. 


These error codes begin with the number 32 to avoid conflicting 
with previously defined and documented system error codes. 


In BASIC, you can check this status byte via a PEEK $678+s (s is the 
SSC slot), and reset it with a POKE command at the same location. 


In Pascal, the IORESULT function returns the error code value. 
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By the way: Any character—including the carriage return at the 
end of a WRITELN statement—will cause posting of a new value 
in IORESULT. 


Table H-7 shows the possible combinations of error bits 
corresponding to these decimal error codes. 


Table H-7 
Error codes and bits 
Errorcode* Carrier lost Overrun Framing error Parity error 
0 No error 
32 Illegal command 
33 No No No Yes 
34 No No Yes No 
35 No No Yes Yes 
36 No Yes No No 
37 No Yes No Yes 
38 No Yes Yes No 
39 No Yes Yes Yes 
40 Yes No No No 
41 Yes No No Yes 
42 Yes No Yes No 
43 Yes No Yes Yes 
44 Yes Yes No No 
45 Yes Yes No Yes 
46 Yes Yes Yes No 
47 Yes Yes Yes Yes 


* Result of PEEK $678+s in BASIC or IORESULT in Pascal 


The ACIA 


The Asynchronous Communication Interface Adapter (ACIA) chip 
is the heart of the Super Serial Card. It takes the 1.8432 MHz signal 
generated by the crystal oscillator on the SSC and divides it down to 
one of the 15 baud rates that it supports. The ACIA also handles all 
incoming and outgoing signals of the RS232-C serial protocol that 
the ACIA supports. 


The ACIA registers control hardware handshaking and select the 
baud rate, data format, and parity. The ACIA also performs parallel 
to serial and serial to parallel data conversion, and buffers data 
transfers. 
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SSC firmware memory use 


Table H-8 is an overall map of the locations that the SSC uses, both 
in the Apple Ile and in the SSC’s own firmware address space. 


Table H-8 
Memory use map 


Address 


$0000-$00FF 


$04xx-$07xx 


$CO(8+s)0-$C0(8+s)F 


$Cs00-$CsFF 


$C800-$CFFF 


Name of area 


Page zero 


Peripheral slot 
RAM 


Peripheral card 
I/O space 


Peripheral card 
ROM space 


Expansion ROM 


Contents 


Monitor pointers, I/O 
hooks, and temporary 
storage. 


Locations (8 per slot) 
in Apple Ile pages $04 
through $07. SSC uses 
all 8 of them. 


Locations (16 per slot) 
for general I/O. SSC 
uses 6 bytes. 


One 256-byte page 
reserved for card in 
slot s; first page of 

SSC firmware. 


Eight 256-byte pages 
reserved for 2K ROM 
or PROM. SSC maps 
its firmware onto 
$C800-$CEFF. 
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Zero-page locations 


Table H-9 re 

Zero-page locations used by the SSC 

Address Name Description 

$24* CH Monitor pointer to current position 
of cursor on screen 

$26 SLOT16 _ Usually (slot x 16); that is, $s0 

$27 CHARACTER Input or output character 

$28* BASL Monitor pointer to current screen line 

$2A ZPTMP1 Temporary storage (various uses) 

$2B ZPTMP2 Temporary storage (various uses) 

$35 ZPTEMP Temporary storage (various uses) 

$36* CSWL BASIC output hook (not for Pascal) 

$37* CSWH High byte of CSW 

$38* KSWL BASIC input hook (not for Pascal) 

$39* KSWH High byte of KSW 

$4E* RNDL Random number location, updated 


when looking for a keypress (not used 
when initialized by Pascal) 


* Not used when Pascal initializes SSC 


Peripheral-card I/O space 


There are 16 bytes of I/O space allocated to each slot in the 

Apple Ile. Each set begins at address $C080 + (slot x 16); for 
example, if the SSC is in slot 3, its group of bytes extends from 
$COBO to $COBF. Table H-10 interprets the six bytes the SSC uses. 


Table H-10 
Address register bits interpretation 
Address Register Bits Interpretation 
$C081+s0 DIPSW1 0 SW1-6 is OFF when 1, ON 
when 0. 
(SW1-x) 1 SW1-5 is OFF when 1, ON 
when 0. 


4-7 Same as above for SW1-4 
through SW1-1. 
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Table H-10 (continued) 
Address register blis Interpretation 


Address Reaister Bits Interpretation 
$C082+s0 DIPSW2 0 Clear To Send (CTS) is true 
when 0. 
(SW2-x) 1-3 Same as above for SW2-5 


through SW2-3. 
5,7 Same as above for SW2-2 and 
SW-2-1. 


$C088+s0 TDREG 0-7 ACIA transmit register 
(write). 
RDREG 0-7 ~~ ACIA receive register (read). 


$C089+s0 STATUS ACIA status/reset register. 

Parity error detected when 1. 

1 Framing error detected 
when 1. 

2 Overrun detected when 1. 

3 ACIA receive register full 
when 1. 

4 ACIA transmit register empty 
when 1. 

5 Data Carrier Detect (DCD) 
true when 0. 

6 Data Set Ready (DSR) true 
when 0. 

7 Interrupt (IRQ) has occurred 
when 1. 


$CO8A+s0 COMMAND ACIA command register 
(read/write). 

0 Data Terminal Ready (DTR): 
enable (1) or disable (0) 
receiver and all interrupts. 

1 When 1, allow STATUS bit 3 to 
cause interrupt. 

2-3 Control transmit interrupt, 
Request To Send (RTS) level, 
and transmitter. 

4 When 0, normal mode for 
receiver, when 1, echo mode 
(but bits 2 and 3 must be 0). 

5-7 Control parity. 
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Table H-10 (continued) 


Address register bits Interpretation 


Address Register Bits 
$CO8B+sO0 CONTROL 


0-3 


5-6 


Interpretation 


ACIA control register 
(read/write). 

Baud rate: $00 = 16 times 
external clock; see Table H-1. 
When 1, use baud rate 
generator; when 0, use 
external clock (not 
supported). 

Number of data bits: 8 (bit 5 
and 6 = 0) 7 6 = 1, 6 = 0), 6 

(6 =0,6=Dor5 (it 5 and6 
both = 1). 

Number of stop bits: 1 if bit 7= 
0; if bit 7 = 1, then 1-1/2 (with 
5 data bits, no parity), 1 (8 
data plus parity), or 2 


Scratchpad RAM locations 
The SSC uses the scratchpad RAM locations listed in Table H-11. 


Table H-11 


Scratchpad RAM locations used by the SSC 


Address Field name Bit 


$0478+s DELAYFLG 0-1 
a 
4-5 
6-7 


$04F8+s  PARAMETE 0-7 


$0578+s STATEFLG 0-2 
3-5 
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Interpretation 


Form feed delay selection. 
Line feed delay selection. 
Carriage return delay selection. 
Translate option. 


Accumulator for firmware’s 
command processor. 


Command mode when not 0. 
Slot to chain to 
(communications mode). 
Set to 1 after lowercase input 
character. 

Terminal mode when 1 
(communications mode). 
Enable CR generation when 1 
(printer mode). 


Table H-11 (continued) 
Scratchpad RAM locations used by the SSC 


Address Field name Bit Interpretation 


$05F8+s CMDBYTE 0-6 Printer mode default is Control- 
I; communications mode 
default is Control-A. 
7 Set to 1 to Zap control 
commands. 


$0678+s STSBYTE Status and IORESULT byte. 


$06F8+s CHNBYTE 0-2 ~ Current screen slot 
(communication mode); when 
slot = 0, chaining is enabled. 
3-7 — $Cs00 space entry point 
(communications mode). 


PWDBYTE 0-7 Current printer width; for listing 
compensation, auto-CR 
(printer mode). 


$0778+s BUFBYTE 0-6 One-byte input buffer 
(communications mode); used 
in conjunction with XOFF 
recognition. 
7 Set to 1 when buffer full 

(communications mode). 

COLBYTE 0-7 Current-column counter for 
tabbing and so forth (printer 
mode). 


$07F8+s | MISCFLG 0 Generate line feed after CR 
when 1. 
1 Printer mode when 0; 
communications mode when 1. 
2 Keyboard input enabled when 1. 
3 Control-S CXOFF), Control-R, 
and Control-T input checking 
when 1. 
4 Pascal operating system when 1, 
BASIC when 0 
Discard line feed input when 1. 
Enable lowercase and special- 
character generation when 1 
(communications mode). 
6 Tabbing option on when 1 
(printer mode). 
a Echo output to Apple IIe screen 
when 1. 


NWN 
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International Versions 


International versions of the Apple He have two sets of keyboard 
characters their users may choose between. One set, known as the 
USA character set, is the standard Apple Ile character set described 
in Chapter 2 of this manual. The other set, known as the alternate 
character set, is a special set of characters designed to meet the 
needs of various international users. This appendix describes the 
layout of the various international keyboards when the alternate 
character set has been selected. A layout drawing and a table of 
character codes generated by the keyboard are provided for each 
version described in this appendix. You should note, however, that 
only the ASCII codes that are different from those in the USA set are 
defined in the tables; where a keyboard does not generate any 
different codes, no table is provided. Figure I-1 is a schematic 
diagram of the international circuit board. 
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Figure I-1b 
International Ile schematic diagram, part 2 
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Figure I-1d 
International lle schematic diagram, part 4 
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The English keyboard 


Figure I-2 shows the English keyboard layout. The English character set generates only 
one character that is different from the USA character set: the & character replaces the 
* character. 













HARARBARKGRS 
} 
BOOSSSsOnoonnssoAnS 
ESssshsssssco Anne 
P= Peet =) LLL: 
ett Teer) GT 


Figure |-2 
English keyboard 


ARBB 






Table I-1 
English keyboard ASCII codes 
Normal Control Shift 
Key Code Char Code Char Code Char Code 
3& 33 3 33 5 23 & 23 


Both 


Char 
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The French keyboard 


The French keyboard layout is shown in Figure I-3. Table I-2 lists the ASCII codes for 
the French character set that are different from those in the USA character set. 


On the French keyboard, the Caps Lock key affects all keys. Pressing the Shift key while 
the Caps Lock key is engaged “unshifts” to lowercase, but only so long as the Shift key is 
held down. 


SABRE BBBBRAEE eel = | 1 
e 





Figure I-3 
French keyboard 


Table I-2 
French keyboard ASCIil codes 

Normal Control Shift Both 
Key Code Char Code Char Code Char Code Char 
&1 26 & 26 & 31 1 31 1 
é2 7B e 7B e 32 2 32 2 
"3 22 " 22 ‘ 33 3 33 3 
'4 2g ; 27 : 34 4 34 4 
6 28 ¢ 28 ¢ 35 5 35 5 
§6 5D § 1D GS 36 6 1D GS 
é7 7D é 7D é 37 7 37 7 
18 21 ! 21 ! 38 8 38 8 
¢9 5C ¢ 1C FS 39 9 39 FS 
a0 40 a 00 NUL 30 0 00 NUL 
) 29 ) 1B ESC 5B 2 1B ESC 
A~ 5E A 1E RS 7E ~ 1E RS 
$* 24 $ 24 $ 2A 9 2A * 
u% 7C u 7C u 25 % 25 % 
“S 60 ; 60 . 23 & 23 & 
at 2C ; 2C ; 3F ? 3F ? 
; 3B ; 3B ; 2E 2E 
/ 3A 3A 2F / 2F ys 
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The Canadian keyboard 


The Canadian keyboard layout is shown in Figure I-4. Table I-3 lists the ASCII codes for 
the Canadian character set that are different from those in the USA character set. 


BHGGRBRERRAEBRS 
}A 
~» Tolwlelalriviulifolelisna | ([ztelel+ 
few Tats fot etetuts tx lili] at ste] -| 
Po Tetxtctvisinimis | velo | Lfe]s) 
’ - t/eé 
~ ? 
fap ¢ PWM det} Le 1) 


Figure I-4 
Canadian keyboard 











Boag 









Table I-3 
Canadian keyboard ASCII codes 

Normal Control Shift Both 
Key Code Char Code Char Code Char Code Char 
2° 32 2 00 NUL 5B 2 00 NUL 
3& 33 3 33 3 23 & 23 & 
6§ 36 6 1E RS 5D § 1E RS 
aé 40 a 7F DEL 7D é 7F DEL 
tA 7C u 7C u 5E A 5E A 
é¢ 7B é 1C FS 5C ¢ 1C FS 
"/ TE » 7E 2F 7 2F / 
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The German keyboard 


The German keyboard layout is shown in Figure I-5. Table I-4 lists the ASCII codes for 
the German character set that are different from those in the USA character set. 






Tite Tobie Tet Tete Tote fom) 
* 
SSSsSsesnsHHHs 


G2m0 Ge BOcCooR ea 


Figure I-5 
German keyboard 


BEBE 











Table |-4 

German keyboard ASCIll codes 

Normal Control Shift Both 

Key Code Char Code Char Code Char Code Char 
2° 32 2 32 2 22 a 22 2 
3§ 33 3 00 NUL 40 § 00 NUL 
6& 36 6 36 6 26 & 26 & 
7/ 37 i 37 7 2F va 2F / 
8¢ 38 8 38 8 28 ¢ 28 ¢ 
9) 39 9 39 9 29 ) 29 ) 

= 30 0 30 0 3D = 3D = 
8? TE & 7E 8 3F ? 3F ? 
U 7D U 1D GS 5D U 1D GS 
+* 2B + 2B + 2A : 2A * 
re) 7C 0 ic FS 5C 6) 1C FS 
A 7B A 1B ESC 5B A 1B ESC 
#A 23 # 1E RS 5E ~ 1E RS 
<> 3C < 3C < 3E > 3E > 
Fe 2C ‘ 2C ? 3B : 3B : 

: 2E 5 2E i 3A ; 3A : 


300 Appendix |: International Versions 


The Italian keyboard 


The Italian keyboard layout is shown in Figure I-6. Table I-5 lists the ASCII codes for the 
Italian character set that are different from those in the USA character set. 


On the Italian keyboard, the Caps Lock key affects all keys. Pressing the Shift key while 
the Caps Lock key is engaged “unshifts” to lowercase, but only so long as the Shift key is 
held down. 


GHXGERUERHRHEEES 
p'Jojztetatriviulitolelits} | trpelo}+J 
poi Tetels la Dili tele talal atso]- 
jo 6 a FCA CE aol 







Sa0u 









Figure 1-6 
Italian keyboard 
Table I-5 
Italian keyboard ASCIl codes 

Normal Control Shift Both 
Key Code Char Code Char Code Char Code Char 
&1 26 & 26 & 31 1 31 1 
"2 22 " 22 " 32 2 32 2 
3 27 ’ 27 : 33 3 33 3 
(4 28 ¢ 28 ¢ 34 4 34 4 
¢5 5C ¢ 1c FS 35 5 1c FS 
&6 7D é 7D é 36 6 36 6 
)7 29 ) 29 ) 37 7 37 7 
£8 23 & 23 & 38 8 38 8 
a9 7B a 7B a 39 9 39 9 
é0 5D é 1D GS 30 0 1D GS 
iA TE i 1E RS 5E A 1E RS 
$* 24 $ 24 $ 2A ‘ 2A . 
u% 60 a 60 u 25 % 25 % 
§° 40 § 00 NUL 5B $ 1B ESC 
<> 3C < 3C < 3E > 3E > 
i 2C ; 2C F 3F ? 3F ? 
: 3B ; 3B ; 2E 2E 
/ 3A 3A 2F / 2F / 


= 
~ 
O 
o 
~~ 
O 
o 
N 

— 
N 
_ 
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The Western Spanish keyboard 


The Western Spanish keyboard layout is shown in Figure I-7. 
Table I-6 lists the ASCII codes for the Spanish character set that are different from 
those in the USA character set. 





Key Code Char Code Char 


Figure |-7 
Western Spanish keyboard 
Table 1-6 
Western Spanish keyboard ASCIl codes 

Normal Control 
1j 31 1 31 1 
2é 32 2 32 2 
3& 33 3 33 3 
6/ 36 6 36 6 
2 27 “i 27 ‘i 
~§ TE ~ 7F DEL 
N 7S fi 1C FS 
ae 2C j 2C , 
.! 2E : 2E : 
¢" 7D ¢ 1D GS 
<> 3C < 1E RS 
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Shift 


Char 


= ee wy Zim oN fhe - 





Both 


Code 


5B 
5D 
23 
2F 
7B 
7F 
1c 
SF 
21 
1D 
1E 


The Swedish keyboard 


The Swedish keyboard layout is shown in Figure I-8, Table I-7 lists the ASCII codes for 
the Swedish character set that are different from those in the USA character set. 


= 
SEBBHEBEEREREES 
[Jolwletalrtytulifolelal*] | tfelo] + 
cow Tat stole lotutsixti lola e686 
ESE SAG HnneEGES Ranh 
eke FT Te Ce PY 


Figure |-8 
Swedish keyboard 












eae 












Table |-7 
Swedish keyboard ASCII codes 
Normal Control Shift Both 

Key Code Char Code Char Code Char Code Char 
2 22 s 32 2 22 " 32 2 
6& 36 6 36 6 26 & 26 & 
7/ 37 7 37 7 2F / 2F / 
8¢ 38 8 38 8 28 ( 28 ( 

= 30 0 30 0 3D = 3D = 
+? 2B + 2B + 3F ? 3F ? 
27 ‘ 27 ; 60 , 60 ¥ 
aA 7D 4 1D GS 5D A 1D GS 
~A TE ~ 1E RS 5E A 1E RS 
@* 40 @ 00 NUL 2A * 00 NUL 
60 re 6) ic FS 5C O 1C FS 
aA 7B a 1B ESC 5B A 1B ESC 
ee 2C ; 2C ; 3B ‘ 3B ; 
if 2E : 2E j 3A : 3A : 
_—_ 2D ~ 1F US 5F —_ 1F US 
<> 3C < 3C < 3E > 3E > 
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Certification 


In countries where it is applicable, the following product safety 
certification supplements the USA FCC Class B notice printed on 
the inside front cover of this manual. 


Product safety 


This product is designed to meet the requirements of IEC 380, Safety 
of Electrically Energized Office Machines. 


Grounding notice 


This product is intended to be electrically grounded. This product 
is equipped with a power supply plug having a third prong called a 
ground prong. This plug will only fit into a grounding-type AC 
outlet. This is a safety feature. 


If you are unable to insert the power supply plug into the outlet, 
contact a licensed electrician to replace the outlet and, if necessary, 
install a ground. 


Do not defeat the purpose of the grounding-type plug. 
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Power supply specifications 
The basic specifications for the international version of the 


Apple Ie are provided in Table 1-8. 


Table 1-8 
International power supply specifications 


Line voltage 170 to 270 VAC, 50Hz 


Max. input power 70W 
consumption 


Supply voltages +12 VDC @2.5A 
-12 VDC @ .25A 

+5 VDC @2.5A 

-5 VDC @ .25A 


Power supply specifications 


305 


Appendix J 


Monitor 
Firmware 
Listing 


Loe 


0000 


0001 
0000 


F800 
€100 
c300 
c800 


0006 


co0o 
co000 
cool 
co02 
003 
c004 
coos 
C006 
c007 
co008 
co09 
cOOA 
cooB 
cooc 
cooD 
COOE 
cOOF 
colo 
coll 
c012 


1 TEST EQU 0 


:REAL VERSION 


LST ON ;DO LISTING AND SYMBOL TABLES 
MSB ON ;SET THEM HIBITS 

IROTEST EQU 1 
BO TEST 


F8ORG EQU $1800 
CLORG EQU $2100 
C30RG EQU $2300 
C8ORG EQU $2800 
ELSE 
F8ORG EQU $F800 
C1ORG EQU $C1OO 
C30RG EQU $C300 
C80RG EQU $c800 
FIN 
MSB ON 


INCLUDE EQUATES 
FOF IRR IR IRI IR IOI IO II TOR III III IIIT IAA. 


Apple //e Video Firmware 


RICK AURICCHIO 08/81 
E. BEERNINK, R- WILLIAMS 1984 


(C) 1981,1984 APPLE COMPUTER INC. 
ALL RIGHTS RESERVED 


ee eo 


HRI KI IRI RAIA IKI AIK IIIA IIIA IAI AIK. 
* 


GOODF8 EQU 6 ;F8 ROM VERSION 
* 


* HARDWARE EQUATES: 
* 

KBD EOU $c000 
CLRBOCOL EQU $c000 
SET80COL EQU $COO1 
RDMAINRAM EQU $C002 
RDCARDRAM EQU $C003 
WRMAINRAM EQU $C004 ;Write to main RAM 

WRCARDRAM EQU $CO005 iWrite to auxiliary RAM 
SETSLOTCXROM EQU $C006 ;Switch in slot CX00 ROM 
SETINTCXROM EQU $COO7 ;Switch in internal CX00 ROM 
SETSTDZP EQU $C008 sSwitch in main stack/zp/lang.card 
SETALTZP EQU $C009 ;Switch in aux stack/zp/lang.card 
SETINTC3ROM EQU $COOA ;Switch in internal $C3 ROM 
SETSLOTC3ROM EQU $COOB ;Switch in slot $C3 space 
CLR80VID EQU $cO00C ;Disable 80 column video 

SET80VID EQU $COOD ;Enable 80 column video 
CLRALTCHAR EQU $COOE 3;Normal Apple II char set 
SETALTCHAR EQU $COOF 3;Norm/inv LC, no flash 

KBDSTRB EQU $C010 ;Clear keyboard strobe 

RDLCBNK2 EQU $CO0il 32127 if LC BANK2 in use 

RDLCRAM EQU $CO012 32127 if LC is read enabled 


;Read keyboard 

;Disable 80 column store 
3Enable 80 column store 
3Read from main RAM 
3;Read from auxiliary RAM 


0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0020: 
0020: 
0021: 
0022: 
0023: 
0024: 
0025: 
0026: 
0028: 
002A: 
002A: 
002c: 
002c: 
002F: 
002F: 
0030: 
0032: 
0033: 
0034: 
0035: 


013 
C014 
cols 
c016 
co17 
c018 
019 
COLA 
colc 
COlE 
cO1F 
c030 
C054 
c0s5 
co5D 
COSF 
C061 
C062 
c081 
c083 
CcO8B 


FBB3 
FDIB 
FDFO 
FF69 


RDRAMRD EQU $C013 32127 if main RAM read enabled 
RDRAMWRT EQU $C014 32127 if main RAM write enabled 
RDCXROM EQU $COL5 32127 if ROM CX space enabled 
RDALTZP EQU $CO16 32127 if alt. zp & le enabled 
RDC3ROM EQU $CO17 37127 if slot C3 space enabled 
RD8O0COL EQU $c018 32127 if 80 column store enabled 
RDVBLBAR EQU $CO19 3>127 if not vertical blanking 
RDTEXT EQU S$CO1A 32127 if text mode 

RDPAGE2 EQU $CO1C 32127 if page 2 

ALTCHARSET EQU $COLE 32127 if alt char set switched in 
RD8O0VID EQU $COIF 32127 if 80 column video enabled 


SPKR EQU $C030 
TXTPAGE] EQU $C054 
TXTPAGE2 EQU $C055 
CLRAN2 EQU $CO5D 
CLRAN3 EQU $COSF 
BUTNO EQU $C061 
BUTN1 EQU $C062 
ROMIN EQU $C081 
LCBANK2 EOQU $C083 
LCBANK1 EQU $CO8B 
* 


* MONITOR EQUATES: 

* 

F8VERSION EOQU F8ORG+$3B3 ;F8 ROM ID 

KEYIN EQU F8ORG+$51B ;normal input 

cOUuT1 EQU F8ORG+S5FO ;normal output 

MONZ EQU F80ORG+$769 ;monitor entry point 
* 


* ZEROPAGE EQUATES: 
* 


;toggle speaker 
;switches in text page 1 
jswitches in text page 2 
jannunciator 2 
jannunciator 3 
jopen-apple key 
;closed-apple key 

3;swap in DOOO-FFFF ROM 
;swap in LC bank 2 

;swap in LC bank IL 


Loco EQU 0 jused for doing PR# 
LocL EQU 1 jused for doing PR# 

DSECT 

ORG $20 
WNDLFT DS i tscrolling window left 
WNDWDTH DS L ;scrolling window width 
WNDTOP DS l ;scrolling window top 
WNDBTM DS 1 ;scrolling window bottom+] 
CH DS L ;cursor horizontal 
cv DS 1 scursor vertical 

ps 2 ;GBASL,GBASH 
BASL DS 2 ;points to current line of text 


BASH EQU BASL+1 


BAS2L DS 2 ;pointer used for scroll 


BAS2H EQU  BAS2L+1 
* 

ORG $2F 
LENGTH DS 1 j;length for mnemonics 

DS 2 
INVFLG DS 1 }>127=snormal, <127=inverse 
PROMPT DS 1 sused by monitor upshift 
YSAV Ds L jinput buffer index for mini 
SAVYL DS 1 3;for restoring Y 


g0e 


0036: 
0038: 
0038: 
003A: 
003Cc: 
003¢c: 
003E: 
003E: 
0040: 
0040: 
0042: 
0044: 
0044: 
OO4E: 
OO4E: 
0050: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 


0002 
0037 
0002 
0039 
003c 
0002 
003D 
0002 
003F 
0002 
0002 
0043 
0001 
O04E 
0002 
OO4F 


0200 


07 F8 


0478 
O4FB 
057B 
OSFB 
067B 
O6FB 
0778 
077B 
O7FB 
O7FB 


107 
108 
109 
110 
111 
112 
113 
114 
115 
116 
117 
118 
119 
120 
121 
122 
123 
124 
125 
126 
127 
128 
129 
130 
131 
132 
133 
134 
135 
136 
137 
138 
139 
140 
141 
142 
143 
144 


CSWL DS 2 
CSWH EQU CSWL+1 
KSWL ps 2 
KSWH EQU KSWL+1 


shook for output routine 


j;hook for input routine 


ORG $3C 
ALL DS 2 ;Monitor temps for MOVE 
AlH EQU AIL+1 
A2L DS 2 
A2H EQU A2L+1 
DS 2: 343 NOT USED 
ASL DS. 2 
AGH EQU A4Lt1 
MACSTAT DS 1 jmachine state on breaks 
ORG $4E 
RNDL DS 2 ;random number seed 


RNDH EQU  RNDL+1 
DEND 
* 
BUF EQU $200 jinput buffer 
Permanent data in screenholes 


* 


Note: these screenholes are only used by 

the 80 column firmware if an 80 column card 

is detected or if the user explicitly activates 
the firmware. If the 80 column card is not 
present, only MODE is trashed on RESET. 


The success of these routines rely on the 

fact that if 80 column store is on (as it 
normally is during 80 column operation), that 
text page 1 is switched in. Do not call the 
video firmware if video page 2 is switched in!! 


ee eee Re ee 


MSLOT EQU $7F8 

* 

OLDCH EQU $478+3 
MODE EQU $4F8+3 
OURCK EQU $578+3 
OURCV EOU $5F8+3 
CHAR EQU $678+3 scharacter to be printed/read 
XCOORD EQU S$6F8+3 ;}GOTOXY X-coord (pascal only) 
TEMP1 EQU $778+3 itemp 

OLDBASL EQU $778+3 jlast BASL (pascal only) 
TEMP2 EQU $7F8+3 jtemp 

OLDBASH EQU $7F8+3 j;last BASH (pascal only) 


3=$Cn ;n=slot using $C800 


;LAST CH used by video firmware 
;video firmware operating mode 
380 column CH 
380 column CV 





* 

* BASIC MODE BITS 

* 

® O.eee--- — BASIC active 

= - Pascal active 

* 

* = 

* ..0e0-+- —- Print control characters 
* .eleeees — Don't print ctrl chars. 


0040 
0020 
0010 
0008 
0004 
0002 
0001 


0080 
0010 
0008 
0004 
0002 


FA47 
FC74 
FC7A 
F8B7 


NEXT OBJECT 
c100 
c100 


145 
146 
147 
148 
149 
150 
151 
152 
153 
154 
155 
156 
157 
158 
159 
160 
161 
162 
163 
164 
165 
166 
167 
168 
169 
170 
171 
172 
173 
174 
175 
176 
177 
178 
179 
180 
181 
182 
183 
184 
185 
186 
187 
188 
189 
190 
191 
192 
193 
194 
18 
FILE 


seeQovee 


eveleose 
«e020... - Print control characters 
eeeelses — Don't print next ctrl char 


Mouse text inactive 
Mouse text active 


$40 

$20 ;Don't print controls 
$10 

$08 ;Temp ctrl disable 

2 $04 
1 EQU $02 
«MOUSE EQU $01 





Pascal Mode Bits 


- BASIC active 
- Pascal active 





sleweeee 


= Deceee 
eolecece 
- Cursor always on 
seelsee. — Cursor always off 
oaeeOeee — GOTOXY n/a 

- GOTOXY in progress 

- Normal Video 

- Inverse Video 

— PASCAL 1.1 F/W ACTIVE 
- PASCAL 1.0 INTERFACE 
- Mouse text inactive 

- Mouse text active 


oeeQeeee 


sceslece 


weeeeQee 





cccscsel 


eee eee hh TTT TFT TT Hee H eee eH HHH 


M.PASCAL EQU $80 
M.CURSOR EQU $10 
M.GOXY EQU $08 
M.VMODE EQU $04 
M.PAS1.0 EQU $02 
* 


* F8 ROM entries 
* 
NEWBREAK EQU F80RG+$247 
IRQUSER EQU F8ORG+$474 
IRQDONE2 EQU F8ORG+$47A 
TSTROM EQU F8ORG+$B7 
INCLUDE BFUNC 
NAME IS REFLIST.O 
ORG C1ORG 
BFUNCPG EQU * 


;Pascal active 
;Don't print cursor 
;GOTOXY IN PROGRESS 
;PASCAL VIDEO MODE 
;PASCAL 1.0 MODE 


C100: 
c100: 
C100: 
clL00: 
C100: 
C100: 
cLoo: 
C100: 
cLod: 
c100: 
c100: 
C100: 
c100: 
C100: 
cl100: 
C100: 
c100: 
¢€100: 
C100: 
clO0: 
c100: 
C100: 
cl00: 
C100: 
cl100: 
cl100: 
cLOO: 
cLOo: 
€100: 
cl100: 
c100: 
cloo: 
C100: 
cl00: 
c100: 
C100: 
cl00: 
cl00: 
cl00: 
c100: 
cLoO: 
C100: 
C100 :4¢ 
C103: 
C103:A4 
C105:A5 
C107:48 
C108 :20 
CLOB:20 
CLOE:A0 
C110:68 
€111:69 
CL13:¢5 
C115:90 


60€ 


13 C2 


24 
25 


03 CE 
F4 Cl 
00 


00 
23 
FO 


FEC5 
FCFO 


C107 


FUNCEXIT EQU F8ORG+$6C5 ;RETURN ADDRESS 
MINI EQU F80ORG+$4F0 
* 


BASIC FUNCTION HOOK: 


$C100 is called by the patched $F8 ROM. 
It provides an extension to $F8 routines 
that do not workin 80 columns. 


Before jumping here, the $F8 rom disabled 
slot I/O and enabled ROM I/0. This makes 
the entire space from $C100 - $CFFF with the 
exception of the $C300 page available. 


On exit slot 1/0 is restored if necessary. 
INPUT: Y=FUNCTLON AS FOLLOWS: 


KEYIN 

Fix escape char 
BASCALC 

VTAB or VTABZ 

HOME 

SCROLL 

CLREOL 

CLREOLZ 

RESET 

CLREOP 

RDKEY 

SETWND 

Mini Assembler 

set 40 columns on PR#O/IN#O 
Fix pick for monitor 


Cr 


BHO rOMUDUEWNeY 


Stack has PHP for status of internal $CNOO ROM 


Note: If 80 Vid is on and the MODE byte is valid, 
this call will be dispatched to an 80 column routine 
by B.FUNCO. Otherwise it will be dispatched to a 
40 column routine by B.OLDFUNC. In all cases return 
to the Autostart ROM is done through F.RETURN. 


* 
* 
* 
* 
* 
* 
® 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
x 
a 
* 
* 
* 
* 
+ 
* 
* 
* 
* 
* 
* 
B.FUNC JMP DISPATCH ;figure out what to do 
* 
F.CLREOP LDY CH ; ESC F IS CLR TO END OF PAGE 
LDA CV 

CLEOPL PHA 

JSR VTABZ 

JSR X.CLREOLZ 

LDY #$00 

PLA 

Apc #$00 3(carry set) 

CMP WNDBIM 

BCC CLEOP1 


C117:B0 
C119: 

C119:A5 
C11B:85 
C11D:A0 
C11 F:84 
C121:FO 
C123: 

C123:A5 
C125:48 
€126:20 
C129:A5 
C12B:85 
C12D:A5 
C12F:85 
C131:A4 
C133:88 
C134 :68 
C€135:69 
C137:C5 
C139:BO 
C13B:48 
C13C:20 
C1L3F:Bl 
C141:91 
C143:88 
€144:10 
C146:30 
C148:A0 
C14A:20 
C1L4D:A5 
C14F:4C 
C152: 

C152: 

C152:A9 
€154:85 
C156:A9 
C158:85 
CISA:A9 
C15C:85 
C1I5E:D0 
c160: 

C160: 

C160: 

C160:A4 
C€162:4C 
C165: 

C165: 

C165: 

C165:4C 


. €168: 


C168: 
C168: 
€168:4C 


34 «C140 


22 


00 
24 
E4 


22 


03 CE 
28 
2A 
29 
2B 
21 


ol 
23 
OD 


03 CE 
28 
2A 


F9 


c107 


C148 


C13F 


EL €129 


oo 
F4 Cl 
25 


28 
21 
18 
23 
17 
25 
EF 


2A 
F4 Cl 


EB CB 


9A CC 


C152 


C1l4F 


BCS GVTZ ;=>always to VTABZ 


F.HOME LDA WNDTOP 

STA CV 

LbY #$00 

STY CH 

BEQ CLEOPL 3 (ALWAYS TAKEN) 
* 
F.SCROLL LDA WNDTOP 

PHA 

JSR VTABZ 
SCRLL LDA BASL 

STA BAS2L 

LDA BASH 

STA BAS2H 

LDY WNDWDTH 

DEY 

PLA 

apc = #S01 

CMP WNDBIM 

BCS SCRL3 

PHA 

JSR VTABZ 
SCRL2 LDA (BASL),Y 

STA (BAS2L),Y¥ 

DEY 

BPL SCRL2 

BMI SCRLI 
SCRL3 Lby #$00 

JSR X.CLREOLZ 
GVTZ LDA CV 
GVTZ2 JMP VTABZ jset vertical base 
* 
F.SETWND EQU * 

LDA #40 

STA WNDWDTH 

LDA #24 

STA WNDBTM 

LDA #23 

STA CV 

BNE GVTZ2 ;=>go do vtab, exit 
* 


* Load Y from BAS2L and clear line 

* 

F.CLREOLZ LDY BAS2L ;set up by $F8 ROM 
JMP X.CLREOLZ ;and clear line 

* 


* 80 column routines begin here 
* 


B.SCROLL JMP SCROLLUP ;DO IT FOR CALLER 
* 


* Clear to end of line using Y = OURCH 
* 


B-CLREOL JMP X.GS ;clear to end of line 


Ole 


C16B: 

C16B: 

CL6B: 

C16B: 

C16B:A4 
CL6D:4C 
C170: 

C170:4C 
C173:4C 
C176:4C 
C179:4C 
cl7c: 

17:20 
C17F:AD 
C182:85 
C184:8D 
C187 :4C 
C18A: 

C18A: 

C1BA: 

C18A: 

C18A: 

C18A: 

C18A:B4 
C18C:FO 
C18E:CO 
C190: FO 
C192:20 
C195: B4 
C197: FO 
C199:A9 
C19B:95 
C19D:B5 
C19F :60 
CLAO: 

C1LAO:A5 
C1A2:C9 
C1A4:D0 
C1A6340 
CLA9: 

C1LA9:A4 
C1AB: Bl 
CLAD:48 
C1AE:29 
C1B0:09 
C1B2:91 
C1B4:68 
C1B5 :60 
C1B6: 

C1B6:A8 
C1B7:AS 
€1B9:20 
CLBC:90 
CLBE: 


2A 
9D 


74 
AO 
BO 


90 
7B 
24 
7B 
FE 


37 
c3 
F3 
32 


24 


3F 


28 


28 


4c 


C18A 
c19D 


C1A0 
cD 


c19D 


C199 
c8 


CA 
C20A 


lll 
112 
113 
114 
115 
116 
117 
118 
119 
120 
121 
122 
123 
124 
125 
126 
127 
128 
129 
130 
131 
132 
133 
134 
135 
136 
137 
138 
139 
140 
141 
142 
143 
144 
145 
146 
147 
148 
149 
150 
151 
152 
153 
154 
155 
156 
157 
158 
159 
160 


162 
163 
164 


* Clear to end of line using Y = BAS2L 

* which was set up by the $F8 ROM 

* 

B.CLREOLZ LDY BAS2L 
JMP X.GSEOLZ 


sget Y 

;clear to end of line 
* 

B.CLREOP JMP X.VT 
B.SETWND JMP B.SETWNDX 


;CLEAR TO EOS 


B.RESET JMP B.RESETX ;MUST BE IN BFUNC PAGE 
B.RDKEY JMP B.RDKEYX 
* 
B.HOME JSR X.FF 3;HOME & CLEAR 
LDA OURCH 
STA CH ;COPY CH/CV FOR CALLER 
STA OLDCH ;REMEMBER WHAT WE SET 
JMP VTAB scale base & return 
* 
* Complete PR# or IN# call. Quit video firmware 
* if PR#O and it was active (B.QUIT). Complete call 
* if inactive (F.QUIT). 
* 


B.QUIT EQU * 


LDY LOocO,x swas it PR#O/IN#0? 
BEQ NOTO 3=>no, not slot 0 
CPY #KEYIN jwas it IN#f0? 
BEQ IsS0 ;=>yes, update high byte 
JSR QUIT squit the firmware 
F.QUIT LDY LOCO,xX szet low byte into Y 
BEQ NOTO snot slot 0, firmware inactive 
F8HOOK LDA #<KEYIN  j;set high byte to $FD 
STA LOC1,X 
NOTO LDA LOC1,X srestore accumulator 
RTS 
* 
Iso LDA CSWH jis $C3 in output hook? 
CMP #<BASICIN 
BNE F8HOOK 3™>no, set to $FDOC 
JMP C3IN selse set to $C305, exit A=$C3 


F.RDKEY LDY CH 
LDA (BASL),Y 


selee do normal 40 cursor 
jgrab the character 


PHA 

AND #$3F 3set screen to flash 

ORA #$40 

STA (BASL),Y j;and display it 
F.NOCUR PLA 

RTS jreturn (A=char) 


* 

F.BASCALC TAY 
LDA BASL 
JSR  BASCALC 
BCC F.RETURN 


;restore Y 
;restore A 
j;calculate base address 


;BASCALC always returns BCC! 
* 


CIBE: 
C1BE:20 
C1CL:A0 
C13: 
C1C3:D9 
c1C6:D0 
C1C8:B9 
C1CB: 
C1CB:88 
cicc:10 
C1CE:30 
C1D0: 
C1D0:20 
C1D3:4C 
C1D6: 
C1D6: 
C1D6: 
C1D6:8A 
C1LD7:29 
C1D9:85 
C1DB:A5 
CLDD:29 
CLDF:4C 
CLE2: 
C1E2:20 
CLES:8A 
CLE6:85 
C1E8:60 
CLES: 
C1E9: 
CLES: 
CLE9:AC 
C1EC:20 
CLEF:09 
CLF1:60 
C1F2: 
CLF2: 
CIF2: 
CLE2: 
C1LF2:A4 
CLF4:A9 
CLF6:2C 
CLF9:10 
C1FB:24 
CLFD:30 
CLFF:A9 
€201:4C 
C204: 
C204: 
C204: 
C204: 
C204:A8 
C205:A5 
€207:20 


03 
EE 


03 
Ad 


F5 
3A 


70 
OA 


03 


7B 


80 


28 
03 


CLBE 


c1c3 
c2 

CICB 
co 

C1CB 


c1c3 
C20A 


c8 


cA 


05 
CE 


CLF2 


co 
c201 
c201 


cc 


CE 


165 
166 
167 
168 
169 
170 
171 
172 
173 
174 
175 
176 
177 
178 
179 
180 
181 
182 
183 
184 
185 
186 
187 
188 
189 
190 
191 
192 
193 
194 
195 
196 
197 
198 
199 
200 
201 
202 
203 
204 
205 
206 
207 
208 
209 
210 
211 
212 
213 
214 
215 
216 
217 
218 


B.ESCFIX EQU * 

JSR UPSHFT 
B.ESCFIX) LDY #4-1 
B.ESCFIX2 EQU * 

CMP ESCIN,Y ;1S IT? 

BNE B.ESCFIX3 ;=>NAW 

LDA ESCOUT,Y ;YES, TRANSLATE IT 
B.ESCFIX3 EQU * 


;upshift lowercase 
3;SCAN FOR A MATCH 


DEY 
BPL B.ESCFIX2 
BMI F.RETURN ;RETURN:CHAR IN AC 
* 
F.BOUT JSR BOUT yprint the character 
JMP F.RETURN ;AND RETURN 
* 
* Do displaced mnemonic stuff 
* 
MNNDX TXA 3get old acc 
AND #$03 jmake it a length 
STA LENGTH 
LDA BAS2L jget old Y into A 
AND #$8F 
JMP DOMN sand go to open spaces 
* 
GOMINI JSR MINI ;do mini~assenbler 
TXA 3X0. Set mode to 0, and counter 
STA YSAV 3so not CR on new line 
RTS 
* 
* Pick an 80 column character for the monitor 
* 
FIXPICK LDY OURCH jget 80 column cursor 
JSR PICK 3;pick the character 
ORA #$80 jalways pick as normal 
RTS sand return 


* 


*® Load CH into Y and clear line 
* 
F.CLREOL EQU * 
X.CLREOL LDY CH ;get horizontal position 
X.CLREOLZ LDA #$A0 3store a normal blank 
BIT ALTCHARSET ;unless alternate char set 
BPL X.CLREOL2 


BIT INVFLG jand inverse 
BMI X.CLREOL2 
LDA #$20 suse inverse blank 


X.CLREOL2 JMP CLR4O 
* 


;clear to end of line 


* Call VTAB or VTABZ for 40 or 80 columns. Acc (CV) 
* is saved in BASL. 
x 
F.VTABZ TAY ;restore Y¥ 
LDA BASL sand A 
JSR VTABZ 3do VTABZ 


LLE 


C20A: 
C20A: 
C20A: 
C20A: 
C20A; 
€20A:28 
C€20B:30 
c20D:4¢ 
c210:4¢ 
213: 
C213: 
C213: 
C213: 
€213:88 
€214:30 
C216:88 
€217:30 
C219:88 
€21A:30 
C21C:88 
C21D:30 
C21F:88 
€220:30 
C222: 
C222: 
C222: 
€222:A9 
€224:48 
C225:A9 
C227 :48 
C228: 
C228: 
C228: 
C228: 
C228: AD 
C22B:29 
C22D:D0 
C22F:98 
C230:18 
€231:69 
€233:48 
C234:20 
€237:20 
C23A:68 
C23B:A8 
c23C: 
C23: 
C23c: 
C23C:A9 
C23E:48 
C23F:B9 
£242 248 
C243: 
C243: 


03 
C5 FE 
C8 FE 


BA 
AS 
9A 
3D 


E2 


C2 


09 


FB 04 
D6 
oD 
oc 


50 c8 


C20A 


c210 


c1D0 
C1LBE 
C1B6 
c25c 


C204 


€23¢ 


FE CD 


cl 


44 C2 


219 * 

220 * EXIT. EITHER EX{T WITH OR WITHOUT 

221 * ENABLING I/O SPACE. 

222 * 

223 F.RETURN EQU * 

224 PLP 3GET PRIOR 1/0 DISABLE 
225 F.RET2 BMI F.RET! 3™>LEAVE IT DISABLED 
226 JMP FUNCEXIT ;=>EXIT & ENABLE 1/0 

227 F.RETL JMP FUNCEXIT+3 ;EXIT DISABLED 

228 * 

229 * Do BOUT, ESCFIX, BASCALC, and KEYIN immediately 
230 * to avoid destroying Accumulator. 

231 * 

232 DISPATCH DEY 

233 BMI F.80UT scode 0 = 80 column output 
234 DEY 

235 BMI B.ESCFIX j;code 1 = ESCFIX 

236 DEY 

237 BMI F.BASCALC ;code 2 = BASCALC 

238 DEY 

239 BML B.KEYIN ;code 3 = KEYIN 

240 DEY 

241 BMI F.VTABZ ;code 4 = VTABZ 

242 * 

243 * First push address of generic return routine 
244 * 

245 LDA #<F.RETURN ;return to F.RETURN 

246 PHA 

247 LDA #>F.RETURN-1 

248 PHA 

249 * 

250 * If any of 5 bits in $4FB (MODE) is on, then the mode is not 
251 * valid for video firmware. Use old routines. 
252.°* 

253 LDA MODE sno, is mode valid? 

254 AND #M.PASCAL+M.6+M.4+M.24+M.1 

255 BNE GETFUNC ;™>no, use 40 column routines 
256 TYA 380 column routines in 
257 CLC 32nd half of table 

258 ADC #TABLEN 

259 PHA 

260 JSR CSETUP ;set up 80 column cursor 
261 JSR VTAB 3calc base 

262 PLA 

263 TAY 3restore Y 

264 * 

265 * Now push address of routine 

266 * 

267 GETFUNC LDA #<BFUNCPG ;stuff routine address 
268 PHA 

269 LDA F.TABLE,Y 

270 PHA 

271 ® 

272 *® RTS goes to routine on stack. When the routine 


C243: 
C243: 
C243: 
€243:60 
C244: 
C244: 
C244: 
C244: 
C244: 
€244:18 
€245:22 
C246:F1 
C€247:5F 
C248:75 
286 
€249:02 
C24A:A8 
C24B:51 
C24C:El 
C24D:94 
C24E:E8 
C24F:D5 
C250: 
250: 
€250: 
€250:7B 
€251:64 
€252:67 
C253:6A 
€254:75 
C255:6F 
C€256:78 
C€257:72 
€258:E1 
€259:89 
C25A:E8 
C25B:D5 
C25C: 
c25c: 
€25C:2C LF CO 
C25F:10 06 
€261:20 74 C8 
€264:4C OA C2 
C267: 
€267:AB 
C268:8A 
€269:48 
C26A:98 
C26B:48 
C26C:48 
C26D: 
C26D:68 
C26E:C9 FF 
C€270:FO 04 


273 
274 
275 
276 
277 
278 
279 
280 
C244 281 
282 
283 
284 
285 


DFB 
287 
288 
289 
290 
291 
292 
293 
294 
oo0c 295 
296 
297 
298 
299 
300 
301 
302 
303 
304 
305 
306 
307 
308 
309 
c25c 310 
311 
C267) 312 
313 
314 
315 
316 
317 
318 
319 
320 
321 
322 
323 
324 
€276 «325 


* does an RTS, it returns to F.RETURN, which restores 
* the INTCXROM status and returns. 
* 


RTS 
* 
* Table of routines to call. All routines are 
* in the $C100 page. These are low bytes only. 
* 
F.TABLE EQU * 
DFB #>F.HOME-1 ;(5) 40 column HOME 
DFB #>F.SCROLL-1 ;(6) 40 column scroll 
DFB  #>F.CLREOL-1 ;(7) 40 column clear line 
DFB #>F.CLREOLZ-1 ;(8) 40 column clear with Y set 


#>B.RESET-1 ;(9) 40/80 column reset 
DFB #>F.CLREOP-1 ;(A) 40 column clear end of page 
DFB #>F.RDKEY-1 ;(B) readkey w/flashing checkerboard 
DFB #>F.SETWND-1 ;(C) Set 40 column window 
DFB #>GOMINI~-1 ;(D) Mini-assembler 
DFB #>F.QUIT-1 ;(E) quit before IN#O,PR#O 
DFB #>FIXPICK-1 ;(F) fix pick for 80 colums 
DFB_ #>MNNDX-1 ;(10) calc mnemonic index 
* 


TABLEN EOQU 
* 


*-F TABLE 


DFB #>B-HOME-] ;(11) 80 column HOME 
DFB #>B.SCROLL-1 ;(12) 80 column scroll 
DFB #>B.CLREOL-1 ;(13) 80 column clear line 
DFB #>B.CLREOLZ-1 ;(14) 80 column clear with Y set 
DFB #>B.RESET-1 ;(15) 40/80 column reset 
DFB_ #>B.CLREOP-1 ;(16) 80 colum clear end of page 
DFB #>B.RDKEY-1 ;(17) readkey w/inverse cursor 
DFB #>B.SETWND-1 ;(18) 40/80 column VTAB 
DFB #>GOMINI-1 ;(19) Mini-Assembler 
DFB #>B.QUIT-1 ;(1A) quit before IN#0,PR#O 
DFB #>FIXPICK~1 ;(1B) fix pick for 80 columns 
DFB #>MNNDX-1 ;(1C) cale mnemonic index 
* 
B.KEYIN EQU * 
BIT RD8OVID 
BPL 8.KEYINI 
JSR BIN - 
GOF.RET JMP F.RETURN 
* 


380 columns? 

;=>no, flash the cursor 
jget a keystroke 

sand return 


B.KEYINI TAY spreserve A 
TXA 3;put X on stack 


TYA jrestore A 
PHA 3save char on stack 
PHA sdummy for cursor/char test 


NEW.CUR PLA 
CMP #SFF 
BEQ NEW.CURL 


sget last cursor 
jwas it checkerboard? 
s=>yes, get old char 


ZLe 


C272:A9 
€274:D0 
C276:68 
C277 :48 
C278:48 
C279:A4 
C27B:91 
C27D: 
C27D: 
C27D: 
C27D: 
C27D:E6 
C27F:D0 
C€281:A5 
C283:E6 
€285:45 
€287:29 
C€289:D0 
C28B: AD 
C28E:10 
C290: 
C290 :68 
C291:68 
C292:A4 
€294:91 
€296:68 
C297:AA 
C298:AD 
C29B:8D 
C€29£:30 
C2A0: 
C2A0: 
C€2A0:20 
C2A3:2C 
C2A6:10 
C2A8:06 
C2AA: AS 
C2AC:8D 
C2AF:60 
C2B0: 
c2B0: 
C2B0: 
C2B0: 
C2B0:A9 
€2B2:8D 
C2B5:AD 
C2B8:AD 
C2BB: 
C2BB: 
C2BB: 
C2BB: 
C2BB: 
C2BB: 
C2BB:AD 


FF 
02 . C278 


24 
28 


4E 
OA C28B 
4F 
4F 
4F 


E2. C26D 


00 CO 
ED c27D 


C4 = C264 


C2A0 


02 C2AA 


C2B0 
FF 
FB 04 
5D co 
5F cO 


62 co 


326 
327 
328 
329 
330 
331 
332 
333 
334 
335 


336: 


337 
338 
339 
340 
341 
342 
343 
344 
345 
346 
347 
348 
349 
350 
351 
352 
353 
354 
355 
356 
357 
358 
359 
360 
361 
362 
363 
364 
365 
366 
367 
368 
369 
370 
371 
372 
373 
374 
375 
376 
377 
378 
379 


LDA #SFF sno, get checkerboard 
BNE NEW.CUR2 ;=>always 
NEW.CUR1 PLA jget character 
PRA ;into accumulator 
NEW.CUR2 PHA ;save for next cursor check 
LDY CH jget cursor horizontal 


STA (BASL),Y ;and save char/cursor 


* 

* Now leave char/cursor for awhile or 

* until a key is pressed. 

* 

WALTKEY! INC RNDL 
BNE WAITKEY4 


;bump random seed 
;=>and check keypress 


LDA RNDH jis it time to blink yet? 

INC RNDH 

EOR RNDH 

AND #840 

BNE NEW.CUR s=>yes, blink it 
WAITKEY4 LDA KBD yIvories been tickled? 

BPL WAITKEYL jno, keep blinking 
* 

PLA ;pop char/cursor 

PLA ;pop character 

LDY CH sand display it 

STA (BASL),Y j;(erase cursor) 

PLA jrestore X 

TAX 

LBA KBD jnow retrieve the key 


STA KBDSTRB 
BMI GOF.RET 


sclear the strobe 

;=>exit always 

* 

B.SETWNDX EQU * 
JSR F.SETWND 
BIT RD80VID 
BPL SKPSHFT 


3set 40 column width 
380 columns? 
3=>no, width ok 


ASL WNDWDTH smake it 80 
SKPSHFT LDA CV 
STA OURCV yupdate OURCV 
RTS 
* 
* HANDLE RESET FOR MONITOR: 
* 
B.RESETX EQU * 
LDA #S$FF ;DESTROY MODE BYTE 
STA MODE 
LDA CLRAN2 ; SETUP 


LDA CLRAN3 3; ANNUNCIATORS 
* 
* IF THE OPEN APPLE KEY 
* (ALIAS: PADDLE BUTTONS 0) IS 
* DEPRESSED, COLDSTART THE SYSTEM 
* AFTER DESTROYING MEMORY: 
* 


LDA BUTNI 3GET BUTTON 1 (SOLID) 


C2BE:10 
c2c0:4¢ 
€2C3:AD 
C2C6:10 
C2C8: 
Cc2C8: 
C2c8: 
C2Cc8: 
€2C8:A0 
C2CA:A9 
c2cc:85 
C2CE:A9 
C2N0:38 
C2D1: 
C201:85 
€203:48 
C2D4:A9 
C2D6:91 
C208 :88 
C2D9:91 
C2DB: 68 
C2DC:E9 
C2DE:C9 
C2E0:D0 
C2E2: 
C2E2: 
C2E2: 
C2E2: 
C2E2: 
C2E2: 
C2E2: 
C2E2: 
C2E2: 
C2E2: 
C2E2: 
C2E2:8D 
C2E5:20 
C2E8: DO 
C2RA:8D 
C2ED:60 
C2EE: 
C2EE:88 
C2F2: 
C2F2:A4 
C2F4:B1 
C2F6:2C 
C2F9:30 
C2FB:4C 
C2FE: 
C2FE: 
C2FE: 
C300: 
s 
c300: 


03 
oo 
61 
1A 


3D 


AO 
3¢ 


3c 


ol 


EF 


OB 
89 
03 
OA 


95 


24 
28 
1F 
F2 
26 


c2c3 
c6 
co 
C2E2 


C2D1 


c2D1 


C2E2 
co 
CA 
C2ED 
co 


8A 8B 


co 
C2ED 
CE 


0002 
0002 
0000 


380 
381 
382 
383 
384 
385 
386 
387 
388 
389 
390 
391 
392 
393 
394 
395 
396 
397 
398 
399 
400 
401 
402 
403 
404 
405 
406 
407 
408 
409 
410 
4il 
412 
413 
414 
415 
416 
417 
418 
419 
420 
421 
422 
423 
424 
425 
426 
427 
428 
429 
430 
431 
432 
433 


BPL NODIAGS j=>Up, no diage 
JMP DIAGS s=>else go do diagnostics 
NODIAGS LDA BUTNO ;GET BUTTON 0 (OPEN) 
BPL RESETRET ;=>NOT JIVE OR DIAGS 
* 
* BLAST 2 BYTES OF EACH PAGE, 
* INCLUDING THE RESET VECTOR: 
* 
Loy #$BO ;LET IT PRECESS DOWN 
LDA #0 
STA AIL 
LDA #SBF ;START FROM BFXX DOWN 
SEC ;FOR SUBTRACT 
BLAST EoU * 
STA ALH 
PHA ;Save acc to store 
LDA #SA0 ;blanks 
STA (AIL),Y 
DEY 
STA (ALL),Y 
PLA jrestore acc for counter 
sBC #1 ;BACK DOWN TO NEXT PAGE 
cmp o#l ;STAY AWAY FROM. STACK! 
BNE BLAST 
* 
* If there is a ROM card plugged into slot 3, 
* don't switch in the internal ROM C3 space. If not, 
* only switch them in if there is a RAM card 
* in the video slot. 
* 
* NOTE: The //e powers up with internal $C3 ROM switched 
* in. TSTROMCARD switches it out, RESETRET may or may 
* not switch it back in. 
* 


RESETRET EQU * 


STA SETSLOTC3ROM ;swap in slot 3 

JSR TSTROMCRD ;ROM or no card plugged in? 

BNE GORETNIL ;=>ROM or no card, leave $C3 slot 
STA SETINTC3ROM ;card, enable internal ROM 


GORETNI RTS 


* 


ESCIN DFB 


* 


Be 


* 


$88 ,$95,S8A,S8B 


RDKEYX LDY CH 
LDA (BASL),Y 


;get cursor position 
j;and character 


BIT RDBOVID 380 columns? 
BMI GORETNI ;=>don't display cursor 
JMP INVERT ;else display cursor, exit 


ZSPAREC2 EQU C30RG-* 


DS  C30RG-* ,0 
IFNE *-C30RG 
FAIL 2,'C300 
FIN 


overflow’ 


ele 


300: 
c300: 
C300: 
300: 
c300: 
300: 
€300: 
c300: 
300: 
C300: 
C300: 
C300: 
C300: 
€300:2C 43 CE 
€303:70 12 
€305: 
c305: 
c305: 
305; 
Cc305: 

C305 338 
C306 :90 
C307: 
C307: 
C307: 
C307: 
€307: 
€307:18 
C308 : BB 
€309:50 0C 
C30B: 
C30B: 
C30B: 
C30B: 
C30B7 
C30B: 
C30B: 
C30B: 
C30B:01 
C30C 288 
C30D; 
C30D:4A 
C30E:50 
C30F :56 
C€310:5C 
C311: 
C311: 
C311: 
C311: 
C311:4C 76 C3 
€314:4C C3 C3 
C317: 
C317: 
C317:8D 7B 06 


€300 
€300 


C317 


C305 


C307 


C317 


COnNAUFwWKHK wo 
a 


Ree Re eee eee 
SOeMOINDUEWNRK OS 


N 


NNN 
wn 


INCLUDE C3SPACE 
FEIT IO TAIT ID AIO IIT IIIA 


THIS IS THE $C3XX ROM SPACE: 

Note: This page must not be used by any routines 

called by the F8 ROM. When it is referenced, it claims 

the C800 space (kicking out anyone who was using it). 

This also means that peripheral cards cannot use the AUXMOVE 
and XFER routines from their C800 space. 


FOI III III IR IIIT AIO I II ITO IASI IIIA 
cNnoo EQuU * 
BASICINT EQU * 

BIT SEV 

BVS BASICENT 


jset vflag (init) 
;(ALWAYS TAKEN) 
* 
* BASIC input entry point. After a PR#3, this is the 
* address that is called to input each character. 
* 
BASICIN EQU * 
SEC 


DFB $90 ;BCC OPCODE (NEVER TAKEN) 


* 
* BASIC output entry points After a PR#3, this is the 
* address that is called to output each character. 
* 
BASICOUT EQU * 

CLO 

CLV }CLEAR VFLAG (NOT INIT) 

BVC BASICENT ;(ALWAYS TAKEN) 
* 


* Pascal 1.1 Firmware Protocol table: 

* 

* This tables identifies this as an Apple //e 80 column 
* card. It points to the four routines available to 

* programs doing 1/0 using the Pascal 1.1 Firmware 

* Protocol. 

* 


DFB $0l 
DFB $88 


;GENERIC SIGNATURE. BYTE 
;DEVICE SIGNATURE BYTE 


DFB #>JPINIT 
DFB #>JPREAD 
DFB #>JPWRITE ;PASCAL WRITE 


DFB #>JPSTAT ;PASCAL STATUS 
RIK IIR IIR IIR IR ITI I III IIR IO IASI REI AIA 


* 


* 128K SUPPORT ROUTINE ENTRIES: 
* 


;PASCAL INIT 
;PASCAL READ 


JMP MOVE ;MEMORY MOVE ACROSS BANKS 


JMP XFER ; TRANSFER ACROSS BANKS 
FEO TOI III TO TOI OOOO I TOR IIA IIH 


* 
BASICENT STA CHAR 


C31A:98 
C31B:48 
C31C:8A 
C31D:48 
C31E:08 
C31F: 
C31F: 
C31F: 
C31F: 
C31F: 
C31F: 
C31F:AD 
€322:2C 
€325:30 
€327:09 
C329:8D 
c32c: 
c32C: 
€32C:20 
C32F:28 
€330:70 
C332: 
C332: 
C332: 
C332: 
C332: 
C€332:90 
C334:AA 
€335:10 
€337:20 
C33A:68 
C33B:AA 
C33C:68 
C33D:A8 
C33E:AD 
C341:6C 
C344: 
C344:4C 
C347 :4C 
C34A: 
C34A: 


C34A:20° 


c34D:4C 
C350: 

€350:20 
€353:4C 
C356: 

C€356:20 
€359:4C 
C35C: 

C35C:AA 
C35D: FO 
C35SF:CA 
C360:DO 


10 


oD 
5B 


7B 
38 


7c 
03 
6D 
B4 


6D 
D6 


6D 
FO 
08 


07 


04 
c32¢ 
04 


C32C 
c3 


C347 


C344 


0344 
cp 


C367 


C369 


TYA 3; AND Y 

PHA 

TXA 3; AND X 

PHA 

PHP ;SAVE CARRY & VFLAG 


* 

* If escape mode is allowed, the high bit of MSLOT is 

* clear. Set M.CTL to flag that 1) escapes are allowed, and 
* 2) that control characters should not be echoed. 


* M.CTL is cleared by BPRINT. 
*x 


LDA MODE jelse esc enable, ctl disable 
BIT MSLOT sget MSLOT 
BMI NOGETLN 3;=>Esc disable, ctl char enable 
ORA #M.CTL 
STA MODE 
* 
NOGETLN EQU * 
JSR SETC8 ;SETUP C8 INDICATOR 
PLP ;GET VFLAG (INIT) 
BVS JBASINIT ;=>DO THE INIT 
* 


* If a PR#O has been done, input should be transferred 
* from the video firmware to KEYIN. This is detected 
* if the high bit of the mode byte is set. 


* 
Bee Jc8 ;™>output, no problem 
TAX ;test mode 
BPL JC8& jvideo firmware is on 
JSR SETKEYIN ;else set FDIB as input 
PLA ;restore registers 
TAX 
PLA 
TAY 
LDA CHAR 
JMP (KSWL) ;go input the character 
* 
Jc8 JMP C8BASIC  ;GET OUT OF CN SPACE 
JBASINIT JMP BASICINIT ;=>GOTO C8 SPACE 


* 
JPINIT EQU * 


JSR SETC8 ;SETUP C8 INDICATOR 
JMP PINIT ;XFER TO PASCAL INIT 
JPREAD EQU * 
JSR SETC8 ;SETUP C8 INDICATOR 
JMP PREAD ;XFER TO PASCAL READ 
JPWRITE EQU * 
JSR SETC8 ;SETUP C8 INDICATOR 
JMP PWRITE ;XFER' TO PASCAL WRITE 
* 
JPSTAT TAX jis request code = 0? 
BEQ PLIORDY 3=>yes, ready for output 
DEX scheck for any input 
BNE PSTERR j=>bad request, return error 


ple 


€362:2C 00 CO 
C€365:10 04 C36B 
C367 :38 

C368 :60 

C369: 

€369:A2 03 
C36B:18 

C36C:60 

C36D: 

C36D: 

C36D: 

C36D: 

C36D: 

C36D: 

C36D: 

C36D: 

C36D: 

C36D: c36D 
C36D:A2 C3 
C36F:8E F8 07 
C372:AE FF CF 
€375:60 

C376: 

C376: 

C376: 

C376: 

C376: 

C376: 

C376: 

C376: 

C376: 

C376: 

C376: 

C376: 

C376: 

C376: C376 
C376 3:48 

C377:98 

C378:48 

C379:AD 13 CO 
C37C:48 

C37D:AD 14 CO 
C380:48 

C381: 

C381: 

C381: 

C381:90 08 C38B 
C383:8D 02 CO 
€386:8D 05 CO 
C389:B0 06 C391 
C38B: 

C38B: C38B 
C38B:8D 04 CO 
C38E:8D 03 CO 


108 
109 
110 
lll 
112 
113 
114 
115 
116 
117 
118 
119 
120 
121 
122 
123 
124 
125 
126 
127 
128 
129 
130 
131 
132 
133 
134 
135 
136 
137 
138 
139 
140 
141 
142 
143 
144 
145 
146 
147 
148 
149 
150 
151 
152 
153 
154 
155 
156 
157 
158 
159 
160 
161 


BIT KBD j;look for a key 
BPL PNOTRDY 3=>no keystroked 
PIORDY SEC 
RTS 
* 
PSTERR LDX #3 yelse flag error 
PNOTRDY CLC 
RTS 
FAI C OO TI IIIS III III IIA I AR 
* NAME : SETC8 
* FUNCTION: SETUP IRQ $C800 PROTOCOL 


* INPUT : NONE 
* OUTPUT : NONE 
* VOLATILE: NOTHING 


* CALLS : NOTHING 
HIKARI RRR K IIR RIS IBR IR IISA IAI IAIN 


* 

SETC8 EQU * 
Lox #<cNoO 
STX MSLOT 
LDX $CFFF 
RTS 

HH ARERE RIKER ERIK IRERERIRERERERERERERRERR 

* NAME : MOVE 

FUNCTION: PERFORM CROSSBANK MEMORY MOVE 

INPUT Al=SOURCE ADDRESS 

A2=SOURCE END 

A4=DESTINATION START 

CARRY SET=MAIN-->CARD 

CLR=CARD-->MAIN 


;SLOT NUMBER 
;STUFF 1T 
skick out other $C8 ROMs 


* 
* 
* 
* 
* 
* 


* OUTPUT =: NONE 


* VOLATILE: NOTHING 
* CALLS —: NOTHING 
RREKREREEEEEREKRERRERERERREEEEEREREEREKKEERK 
* 
MOVE QU * 
PHA 3SAVE AC 
TYA 3 AND Y 
PHA 
LDA RDRAMRD  ;SAVE STATE OF 
PHA ; MEMORY FLAGS 
LDA RDRAMWRT 
PHA 


* 
* SET FLAGS FOR CROSSBANK MOVE: 
* 


BCC MOVEC2M 3™>CARD-->MAIN 

STA RDMAINRAM ;SET FOR MAIN 

STA WRCARDRAM ; TO CARD 

BCS MOVESTRT ;=>(ALWAYS TAKEN) 
* 


MOVEC2M EQU * 


C391: 
C391: 
C391:A0 00 
393: 
C393; 
C393:Bl 3c 
C395:91 42 
C397 :E6 42 
€399:D0 02 
C39B:E6 43 
C39D:A5 3C 
C39F:C5 3E 
C3AL:A5 3D 
C3A3:E5 3F 
C3A5:E6 3C 
C3A7:D0 02 
C3A9:E6 3D 
C3AB:90 E6 
C3AD: 
C3AD: 
C3AD: 
C3AD:8D 04 
C3B0 368 
C3B1:10 03 
C3B3:8D 05 
C3B6: 
C3B6:8D 02 
C3B9:68 
C3BA:10 03 
C3BC:8D 03 
C3BF: 

C3BF :68 
C3C0: A8 
C3C1 368 
C3C2:60 
C3C3: 
C3C3: 
C3C3: 
C33: 
C3C3: 
€3C3: 
C3C3: 
C€3C3: 
C3C3: 
C3C3: 
c3c3: 
C3C3: 
€3C3: 
C3C3: 
C3¢c3: 

03C3 348 
C3C4: 


c391 


393 


c39D 


C3AB 


C393 


co 


C3B6 
co 

C3B6 
co 


C3BF 


co 
C3BF 


€3C3 


STA 
STA 


WRMALNRAM ;SET FOR CARD 
RDCARDRAM ; TO MAIN 


C304: 
C3C4: 


162 

163 

164 

165 

166 
167 

168 
169 

170 
171 

172 
173 

174 

175 

176 
177 

178 
179 
180 
181 

182 

183 
184 
185 
186 
187 
188 
189 
190 
£5: 
192 
193 
194 
195 
196 
197 
198 
199 
200 
201 

202 
203 
204 
205 
206 
207 
208 
209 
210 
211 

212 
213 
214 
215 


* 


MOVESTRT EQU 
LDY 

* 

MOVELOOP EQU 
LDA 
STA 
INC 
BNE 
INC 

NXTAL LDA 
CMP 
LDA 
SBC 
INC 
BNE 
INC 

col BCC 

* 


* 
#0 ;DUMMY INDEX 


* 
(ALL),¥ 
(A4L),Y 
ASL 
NXTAL 
AGH 
AIL 
A2L 

Al 
A2H 
ALL 

col 

AlH 
MOVELOOP ;=>MORE TO MOVE 


;GET A BYTE 
;MOVE IT 


* RESTORE ORIGINAL FLAGS: 


* 
STA 
PLA 
BPL 
STA 
co3 EQU 


MOVERET EQU 


RTS 
RkKKKKKKKKKRK 
NAME 
FUNCTION 
INPUT 


OUTPUT 
VOLATILE 
CALLS 


NOTE 
RRKKERERERAK 


* 


XFER EQU 
PHA 


+e eee eee 


* 


WRMAINRAM ;CLEAR FLAG2 

3;GET ORIGINAL STATE 
co3 3=>IT WAS OFF 
WRCARDRAM 
* 
RDMAINRAM ;CLEAR FLAG] 

;GET ORIGINAL STATE 
MOVERET 3=>IT WAS OFF 
RDCARDRAM 
* 


;RESTORE Y 
3; AND AC 


HEKKKEKKKAKKERERERREREEERERR 


XFER 

TRANSFER CONTROL CROSSBANK 

$03ED=TRANSFER ADDR 

CARRY SET=XFER TO CARD 
CLR=XFER TO MAIN 

VFLAG CLR=USE STD ZP/STK 
SET=USE ALT ZP/STK 

NONE 

$03ED/03EE IN DEST BANK 

NOTHING 


ENTERED VIA JMP, NOT JSR 
HRI IIR RRA KR RR IRIRIR IRIE 


* 
;SAVE AC ON CURRENT STACK 


* COPY DESTINATION ADDRESS TO THE 
* OTHER BANK SO THAT WE HAVE IT 


c3c4: 
C3c4: 
C3C4:AD 
C3C7 348 
C38: AD 
C3CB:48 
C3CC: 
C3CC: 
c3cc: 
C€3CC:90 
C3CE:8D 
C3D1:8D 
C3D4 : BO 
C3D6: 
C3D6:8D 
C3D9:8D 
C3DC: 
Cc3DC: 
f3DC 268 
C3DD:8D 
C3E0 168 
C3E1:8D 
C3E4 368 
C3E5:70 
C3E7 :8D 
C3EA:50 
C3EC:8D 
C3EF:6C 
C3F2: 
C3F2: 
C3F4: 
C3F4: 
C3F4: 
C3F4: 
C3F4:8D 
C3F7:4C 
COPA: 
C3FA: 
C3FA: 
C3FA: 
C3FA: 
C3FA: 
C3FA:2C 
C3FD:8D 
e400: 
C400: 
c400: 
c400: 
c400: 
c400: 
c400: 
C400: 
c400: 
C400 :D8 


Sle 


ED 


EE 


EE 
ED 


os 
08 
03 
09 
ED 


81 
7A 


15 
07 


03 
03 


C3D6 
co 
co 
C3DC 
C3D6 


co 
c3DC 

03 

03 
C3EC 

co 
C3EF 

co 

03 


0002 


co 
FC 


co 
co 


c400 


216. 


217 
218 
219 
220 
221 
222 
223 
224 
225 
226 
227 
228 
229 
230 
231 
232 
233 
234 
235 
236 
237 
238 
239 
240 
241 
242 
243 
244 
245 
246 
247 
248 
249 
250 
251 
252 
253 
254 
255 
256 
257 
258 
259 
260 
261 
262 


DUEW 


* IN CASE WE DO A SWAP: 


LDA $03ED 3;GET XFERADDR LO 
PHA ;SAVE ON CURRENT STACK 
LDA $03EE ;GET XFERADDR HI 
PHA ;SAVE IT TOO 
* 
* SWITCH TO APPROPRIATE BANK: 
* 
BCC XFERC2M }=>CARD-->MAIN 
STA RDCARDRAM ;SET FOR RUNNING 
STA WRCARDRAM ; IN CARD RAM 
BCS XFERZP j=> always taken 
XFERC2M EQU * 
STA RDMAINRAM ;SET FOR RUNNING 
STA WRMAINRAM ; IN MAIN RAM 
* 
XFERZP EQU * ;SWITCH TO ALT ZP/STK 
PLA ;STUFF XFERADDR 
STA $O3EE ; HI AND 
PLA 
STA $03ED 3; LO 
PLA ;RESTORE AC 
BYS XFERAZP s;™>switch in alternate zp 
STA SETSTDZP j;else force standard zp 
BVC JMPDEST 3;=>always perform transfer 
XFERAZP STA SETALTZP ;switch in alternate zp 
JMPDEST JMP ($03ED) j=>0ff we go 
* 
DS C3ORG+SF4-*,0 ;pad to interrupt stuff 
* 
* This is where the interrupt routine returns to. 
* At this point the ROM is not necessarily switched in so... 
* 
IRQDONE STA $C081 ;read ROM, write RAM 


JMP IRQDONE2 j;and jump to ROM 

This is the main entry point for the interrupt 
handler. This switches in the internal ROM and 
jumps to the main part of the interrupt handler 


at $C400. 


a 


rq bit 
sta 


rdcexrom ;Test internal or external rom 
setintcxrom ;Force in ROM to get to interrupt handler 
* 


* Fall into $C400 which is now switched in!! 
* 


INCLUDE IRQ 
* 


* Here is the main interrupt handler 
x 
RERERERARKEREREKRERRERERERKERRRREREERERKERRERK 


newirq equ * 


eld jmake no assumptions!! 


€401:38 
€402:30 
C404:18 
C405:48 
C406 :48 
C407 :48 
C408:8A 
C409: BA 
C40A:E8 
C40B:E8 
C40C:E8 
C40D:E8 
C40E:48 
C40F:98 
C410:48 
C411:BD 
C414:29 
C416:A8 
C417: 

C417:AD 
C41A:20 
C41D:29 
C41F:FO 
C421:A9 
C423:8D 
C426:2A 
€427:2C 
C42A:10 
C420:8D 
C42F:09 
€431:2¢ 
C434:10 
C436:8D 
€439:09 
C43B: 

C43B:2C 
C43E:10 
C440:09 
€442:2C 
€445:10 
C447 349 
C449:8D 
C44C:2C 
C44F:10 
C451:BA 
C452:8E 
C455:AE 
C458:9A 
c€459:8D 
C45C:09 
C45E:88 
C45F:30 
C461:85 
C463 :68 


01 


00 


18 
1c 
80 
05 
20 
54 


13 
05 
02 
20 
14 
05 


10 


12 
oc 
oc 
11 


06 
81 
16 
oD 


ol 
on 


08 


oc 
44 


c405 


01 


co 
co 


C426 
co 
co 
c431 
co 
co 
C43B 
co 
C43B 
co 
c44c 


co 
c449 


co 
co 
C45E 


01 
01 


co 


c46D 


7 sec 
8 bmi 
9 elc 
10 irgintcx pha 
ll pha 
12 pha 
13 txa 
14 tsx 
15 inx 
16 inx 
17 inx 
18 inx 
19 pha 
20 tya 
21 pha 
22 lda 
23 and 
24 tay 
25 * Now test & 
26 lda 
27 and 
28 and 
29 beq 
30 lda 
31 sta 
32 irq2 rol 
33 bit 
34 bpl 
35 sta 
36 ora 
37 irq3 ~~ bit 
38 bpl 
39 sta 
40 ora 
41 irq4 equ 
42 irqS bit 
43 bpl 
44 ora 
45 bic 
46 bpl 
47 eor 
48 irq6 sta 
49 irq? bit 
50 bpl 
51 tsx 
52 stx 
53 ldx 
54 txs 
55 sta 
56 ora 
57 irg8 dey 
58 bmi 
59 sta 
60 pla 


;C=1 if internal slot space 
irgintcx 


;Save A on stack instead of $45 
;Make room for rts if needed 


3;Save X 


3Get stack pointer for BRK bit 
;Can't do add cause we need C 


jand Y 


$100,x 
#510 


;Get status for break test 
3A = $10 if break 
;Save it for later 
set the state of the machine. Don't alter Y 


rd80col ;Test for 80 store and page 2 
rdpage2 
#880 ;Make it 0 or $80 
irq2 ;Branch if no change needed 
#$20 3Set shifted page 2 reset bit 
txtpagel ;Set page 1 
A ;Align bit & shift in slotcx bit 
rdramrd j;Are we reading from aux ram? 
irq3 ;Branch if main ram read 
rdmainram ;Else, switch main in 
#$20 sand record the event 
rdramwrt ;Do the same for ram write 
irg4 
wrmainram 
#$10 
* 
rdlcram ;Determine if language card active 
irq? 
#$0C ;Sets two bits. Second is redundant 
rdlecbnk2 ;if INC used to restore. 
irq6 ;Branch if not page 2 of $D000 
#$06 ;Set bits for page 2 
romin 3;Enable ROM STA leaves write enable alone 
rdaltzp ;Last...and very important 
irq8 ;If alternate stack 
;store current stack pointer at $101 
$101 
$100 ;Retreve main stack pointer from $100 
setstdzp 
#$80 ;Mark stack switched 
wWas it a break? 
irq? 
macstat ;Save state of machine 


;Restore registers 


gle 


C464 248 





C468 :68 
C469:68 
66 





C4AB:48 


pla 


47 PA 


F8 
c3 


FA 


74 


07 


FC 


61 
62 
63 
64 
65 


113 


the switches are read 
and 


tay 
pla 
tax 
pla 
pla 3A stored where RTS address would go 
jmp newbreak ;Go to normal break routine stuff 
irq? pha ;Save state of machine on stack 
lda_ mslot ;Save mslot 
pha 
lda #<irqdone ;Save return irq address 
pha 
lda #>irqdone ;so when interrupt does RTI 
pha 3It returns to irqdone 
php 3Status for user's RTI 
jmp irquser ;0ff to the user 
* The user's RTI returns here 
* BEWARE 
* The rom must be reenabled with a LDA romin 
* This way if the LC was write protected, it still is 
* if it was write enabled, it still is 
* {if it was being write enabled ( 2 ldas), it still will be 
* The restore loop uses an INC because some of 
* and some are write. It must be an INC abs,x since both the 6502 
* the 65C02 do two reads before the write. 
irqfix lda romin 3;Must be Ida! 
pla ;Recover machine state 
bpl = irqdnl ;Branch if main ZP 
sta setaltzp 
ldx $101 3Get alt stack pointer 
txs 
irqdnl ldy #$06 ;¥ * index into table of switch addresses 
irqdn2 bpl irqdn3 ;Branch if no change 
ldx irqtble,y ;Get soft switch address 
inc $C000,x ;Hit the switch. NO PAGE CROSS! 
irqdn3 dey 
bmi irqdn4 
asl A ;Get next bit to check 
bne irqdn2 
irqdn4 asl A 3C = 1 if internal slot space 
asl A 
pla 3Restore the registers 
tay 
tsx ;Save the stack pointer 
Ida #$40 sRTI opcode 
pha 
lda #<setslotcxrom 
pha 
lda #>setslotcxrom 
ade #0 jAdd 1 if internal slot space 
pha 
lda #$8D ;STA setslotcxrom 
pha 


C4AC39A 
C4AD: 8A 
C4AE:69 
C4B0:AA 
C4B1:38 
C4B2:E9 
C4B4:9D 
C4B7 :E8 
C4B8:A9 
C4BA:9D 
C4BD:68 
C4BE:AA 
C4BF:68 
C4C0 :60 


C4C1:83 
c4c4:05 
C4C7: 


03 
07 
00 


ol 
00 


8B 
03 


ol 


01 


8B 
55 


c600 


cos1 
0009 
0001 
0538 
cooo 


c600 


114 
115 
116 
117 
118 
119 
120 
121 
122 
123 
124 
125 
126 
127 


129 
130 
21 


NEXT OBJECT FILE 


txs 

txa. 

ade #3 

tax 

nec 

sbe #7 

sta $100,x 
inx 
lda 
sta 
pla 
tax 
pla 
rts 


;Restore stack pointer 
3Make return address on stack point to code on stack 
3C = 0 from earlier adc 


3;Point to where code starts 


#$1 
$100,x 


3Go to code on stack 


irqtble dfb >I1cbank2,>1cbankl,>lcbankl 

dfb >wrcardram,>rdcardram,>txtpage2 

INCLUDE DIAGS 

REFLIST.1 

ORG C3ORG+$300 

These routines test all 64K RAM, as well as the 64K on an Auxiliary 
‘memory card (when present). With the exception of the INTCXROM switch 
of the LOU, all combinations of the LOU switches are tested and ver- 
ified. All configurations of the MMU switches are also tested. 


NAME IS 


* 
* 
* 
* 
* 
* In the event of any failure, the diagnostic is halted. A message 

* is written to screen memory indicating the source of the failure. 

* When RAM fails the message is composed of "RAM 2P" (indicating failure 
* detected in the first page of RAM) or "RAM" (meaning the other 63.75K), 
* followed by a binary representation of the failing bits set to "1". 

* For example, "RAM 0 1 10000 0" indicates that bits 5 and 6 were 
* detected as failing. To represent auxiliary memory, a "*" symbol is 

* printed preceeding the message. 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 

* 


When the MMU or IOU fail, the message is simply "MMU" or "IOU". 


The test will run continuously for as long as the Open and Closed 
Apple keys remain depressed (or no keyboard is connected) and no 
failures are encountered. The message "System OK" will appear in 
the middle of the screen when a successful cycle has been run and 
either of the Apple keys are no longer depressed. Another cycle 
may be initiated by pressing both Apple keys again while this message 
is on the screen. To exit diagnostics, Control-Reset must be pressed 
without the Apple keys depressed. 
* 
TEXT 
IOUIDX 
MMUIDX 
SCREEN 
IOSPACE 
* 


DIAGS 


$051 
$09 
$01 
$5B8 
$co00 


equ 
equ 
equ 
equ 
equ 


equ * 


C600 :8D 
C603: 
C603: 
603: 
C603: 


€603:A0 
C605:A2 
€607:18 
€608:79 
C60B:95 
C60D:E8 
C60E:D0 
C€610:18 
C611:79 
C614:D5 
C616:D0 
C618:E8 
C619:D0 
C61B:6A 
C61C:2C 
COLF:10 
C621 249 
C623:88 
€624:10 
C626:30 


C€628:55 
C62A:18 
C62B:4C 
C62E: 

C62E:86 
C630:86 
632 786 
C634:A2 
C636 :86 
C638:E6 
CO3A:A8 
C63B:8D 
C63E:8D 
C641:A5 


C651:69 
C653:D0 
C655: A5 
C657:85 
C659:98 
C65A:A0 


LLE 


04 


00 


00 


¥F7 


oo 


10 


FS 


co 


c7 


c7 


co 


c6 


C607 


C628 


610 


C623 


C607 
C62E 


C62E 





* Test Zero-Page, then all of memory. 


sta 


$c050 


Report errors when encountered. 


* Accumulator can he anything on entry. All registers used, but no stack. 
* Addresses between $CO000 and SCFFF are mapped to main $D000 bank. 


* Auxillary 


TSTZPG 


zpl 


zp2 


zp3 


ZPERROR 


TSTMEM 


meml 
mem2 


mem3 


mem4 


ldy 
ldx 
ele 
ade 
sta 
inx 
bne 
ele 
adc 
cmp 
bne 
inx 
bne 
ror 
bit 
bpl 
eor 
dey 
bpl 
bmi 


eor 
cle 
Amp 
equ 
etx 
stx 
stx 
ldx 
stx 
inc 
tay 
sta 
sta 
lda 
and 
cmp 


lda 
lda 
lda 
adc 
bne 
lda 
sta 
tya 
ldy 


64K is also tested if present. 


#S4 
#0 


ntbl,y 
$00,x 


zpl 


ntbl,y 
$00,x 
ZPERROR 


zp2 

a 
RDVBLBAR 
zp3 

#SA5 


zpl 
TSTMEM 


$00,x 


BADBITS 
* 

$01 

$02 

$03 

#4 

$04 

$01 


$c083 
$c083 
$01 
#SFO 
#$C0 
men3 
$CO8B 
$CO8B 
$01 
#$F 
mem4 
$01 
$03 


#$00 


;fi11 zero page with a pattern 


jafter all bytes filled, 
; ACC has original value again. 
380 values can be tested 


;branch if memory failed 
;loop until all 256 bytes tested 


jchange ACC so location $FF will change 
3; use RDVBLBAR for a little randomness... 


juse a different pattern now 
;branch to retest with other value 
;branch always 


swhich bits are bad? 
sindicate zero page failure 


3do RAM $LOO-SFFFF five times 
s;point to page | first 
3save ACC in Y for now 
santicipate not $C000 range... 


3get page address 
;test for $CO-SCF range 


;branch if not... 
;select primary $D000 space 
;Plus carry =+$10 


;branch always taken 


;restore pattern to ACC 
;f111 this page with the pattern 


C65C:18 
C65D:7D 
C660:91 
€662:CA 
€663:10 
€665:A2 
C667 :C8 
C668:D0 
CO6A:E6 
C66C:D0 


C66E:E6 
C670: A8 
C671:AD 
C674:AD 
C677:A5 
C679:29 
€67B:C9 
€67D:D0 
C67F:AD 
C682:A5 
C684 :69 
C686:DO 
C688:A5 
C68A:85 
C68C:98 
68D: A0 
C6BF:18 
€690:7D 
C693:51 
C695:n0 
C697:Bl 
C699:CA 
C69A:10 
C69C:A2 
C69E:C8 
C69F:D0 
C6AL:E6 
C6A3:D0 
C6A5:6A 
C6A6:2C 
C6A9310 
C6AB:49 
C6AD:C6 
C6AF:10 


C6B1L:AA 
C6B2:20 
C6B5:D0 
C6B7:0E 
C6BA:0A 
C6BB:CD 


02 
04 


F2 


ol 
cc 


ol 


Ba 
02 
35 
02 


02 
04 


EE 


cB 


19 


04 
87 


8D 
07 
00 


00 


C7 


C667 


c65c 


C63A 


co 
co 


C688 
co 


C68A 


c7 


cé6cc 


C69E 


C68F 


c670 


C6AD 


C638 


co 
C6BE 
oc 


oc 


87 


98 

99 
100 
101 
102 
103 
104 
105 
106 
107 
108 
109 
110 
111 


133 
134 


136 
137 
138 


memS 


mem6 


mem7 


mem8 
mem9 


memA 


memB 


ele 
adc 
sta 
dex 
bpl 
1dx 
iny 
bne 
inc 
bne 


inc 
tay 
lda 
lda 
lda 
and 
cmp 
bne 
lda 
lda 
adc 
bne 
lda 
sta 
tya 
ldy 
ele 
ade 
eor 
bne 
lda 
dex 
bol 
ldx 
iny 


inc 
bne 
ror 
bit 
bpl 
eor 
dec 
bpl 


TAX 
JSR 


ASL 
ASL 
CMP 


ntbl,x 
($02),y 


mem6 
#4 


memS 
1 
mem2 


$01 


$c083 
$c083 
$01 
#$FO 
#$CO 
mem8 
$c08B 
$01 
#$F 
mem9 
$01 
$03 


#$00 


otbl,x 
($02),y 
MEMERROR 
($02),y 


memB 
#4 


memA 

1 

mem? 

a 
RDVBLBAR 
memC 
#SA5 

$04 

mem) 


STAUX 
SWCHTST1 
$c00 

A 

$coo 


jkeep x in the range 0-4 


yall 256 filled yet? 

;branch if not 

;bump page # 

;loop through $0100 to $FFOO 


s;point to page 1 again 
;save ACC in Y for now 
janticipate not $C000 range... 


3get page address 
;test for $CO-SCF range 


;branch if not... 
;select primary $D000 space 


;Plus carry =+$10 


;branch always taken 


3Testore pattern to ACC 
;fill this page with the pattern 






3if any bits are different, give up!!! 
estore correct pattern 
;keep x in the range 0-4 


jall 256 filled yet? 

3;branch if not 

jbump page # 

jloop through $0100 to $FFOO 

;change ACC for next pass 

3 use RDVBLBAR for a little randomness... 


jhave 5 passes been done yet? 
;branch if not... 


ssave acc 

jset aux memory & write SEE to $C00,$800 
3=>not 128K 

jshift test byte 


;check memory 


ele 


C6BE:DO 
C6cO:cD 
C6C3:FO 
C6C5:8A 
C6C6 :8D 
C6C9:4C 
C6CC 338 
C6CD:AA 
C6CE:AD 
C6D1 : BB 
C6D2:10 
C6D4 :2C 
C6D7 :A9 
C6D9:A0 
C60B:99 
C6DE:99 
C6EL :88 
C6E2 :88 
C6E3: DO 
C6ES5:8D 
C6E8:8D 
C6EB:99 
C6EE:99 
C6F1:99 
C6F4:99 
C6F7 :C8 
C6F8:DO 
C6FA:8A 
C6FB:FO 
C6FD:A0 
C6FF:BO 
C701:A0 
€7033A9 
¢705:50 
707 :8D 
C70A:B9 
C70D:99 
€710:88 
C711L:10 
€713:A0 
€715:8A 
C716:4A 
C7172 AA 
C718:A9 
C71A:2A 
C71B:99 
C71E:88 
C71F:88 
c720:D0 
C722:FO 
C724:A0 
C726:B9 
c729:90 
C72B:B9 


76 
00 
71 


09 
03 


13 


03 


06 
FE 
06 


58 


B6 


¥F3 
FE 
02 
FO 
03 
F3 


C736 
C736 

co 

c6 

co 
C6D7 


c7 


BF 
co 


C6DB 


C6EB 
C724 


703 


0s 


c715 
C722 


c7 
C72E 
c7 


139 
140 
141 
142 
143 
144 
145 
146 
147 
148 
149 
150 
151 
152 
153 
154 
155 
156 
157 
158 
159 
160 
161 
162 
163 
164 
165 
166 
167 
168 
169 
170 
71 
172 
173 
174 
175 
176 
177 
178 
179 
180 
181 
182 
183 
184 
185 
186 
187 
188 
189 


191 
192 


SWCHTST1 BNE 
CMP 
BEQ 
txa 
STA 
jmp 
MEMERROR sec 
BADBITS tax 
lda 
clv 
bpl 
bit 
lda 
ldy 
sta 
sta 
dey 
dey 
bne 
sta 
' sta 
elrs sta 
sta 
sta 
sta 


bbitsl 


clrsts 


badmain lda 


badprim lda 


bbits2 txa 
tax 
lda 
rol 
sta 
dey 
dey 
bne 
hangx beq 
BADSWTCH ldy 
bswtchl lda 

bee 

lda 


SWCHTST s=>not 128K 

$800 ;look for shadowing 

SWCHTST 3=>not 128K 

SETALTZP j;swap in alt zero page 

TSTZPG 3; and test it! 
jindicate main ram failure 
;Save bit pattern in x for now 

RDRAMRD jdetermine if primary or auxillary RAM 
swith V-FLG 

bbits1 ;branch if primary bank 

setv 

#SA0 jtry to clear video screen 

#6 


LOSPACE-2,y 
LOSPACE+6,y 


clrsts 
TEXT 
TXTPAGEL 
$400,y 
$500,y 
$600,y 
$700,y 


elrs 

jtest for switch test failure 
BADSWTCH j;branch if it was a switch 
#3 
badmain 
#5 
#SAA 
badprim 
screen-8 
rmess ,y 
screen-7,y 


sbranch if ZP ok 


j;mark aux report with an asterisks 


badprim jmessage is either "RAM" or "RAM ZP" 
#$10 ;print bits 

a 

#$58 ;bits are printed as ascii 0 or 1 


a 
screen-2,y 


bbits2 

hangx ;hang forever and ever 
#2 

smess ,y 

bswtch2 ;branch if MMU in error 


smesst+3,y ;else indicate IOU error 


C72E:99 
C731:88 
€732:10 
€734:30 


€736:A0 
C738:A9 
C73A:6A 
C73B:BE 
C73E:FO 
€740:90 
C742 :BE 
C745:9D 
€748:C8 
€749:D0 
C74B: 

C74B:AE 
C74E:2A 
C74F:88 
C750: BE 
C753:FO 
¢755:30 
€757:2A 
C758:90 
C75A:1E 
C75D:90 
C75¥F:BO 
C761:1E 
C764: BO 
C746 :90 
C768: 

C768:2A 
C76 
C76A:38 
C76B:E9 
C76D:BO 
C76F:88 
c770:D0 
€772:A0 
€774:D0 
C776: 

C776:A2 
C778:CO 
C77A:4C 
C77D:46 
C77F:D0 
C781:A9 
C783:A0 
C785:99 
C788:99 
C78B:99 
C78E:99 
€791:C8 





05 


€726 
C734 


c7 
C74F 
C745 

c7 

BF 


C73A 


co 


c7 
C768 
C74B 


c761 
co 
C776 
C74F 
co 
C776 
C74F 


C73A 
c77D 


C738 


cé6 


C736 


04 
0s 
06 
07 


193 
194 
195 
196 


198 
199 
200 
201 
202 
203 
204 
205 
206 
207 
208 
209 
210 
211 


213 
214 
215 
216 
217 
218 
219 
220 
221 
222 
223 
224 
225 
226 
227 
228 
229 
230 
231 
232 
233 
234 
235 
236 
237 
238 
239 
240 
241 
242 
243 
244 
245 


bswtch2 


hangy 


SWCHTST 
swtstl 
swtst2 


swtst3 


* 
click 


swtst4 


swtst5 


swtst6 


swerr 


BIGLOOP 
blp2 


blp3 


sta 
dey 
bpl 
bmi 


ldy 
lda 
ror 
1dx 
beq 
bee 
1dx 
sta 
iny 
bne 


ldx 
rol 
dey 
1dx 
beq 
bmi 
rol 
bee 
asl 
bee 
bes 
asl 
bes 
bee 


rol 
iny 
sec 
sbc 
bes 
dey 
bne 
ldy 
bne 


1dx 
cpy 
jmp 
Isr 
bne 
lda 
ldy 
sta 
sta 
sta 
sta 
iny 


screen,y 


bswtchl 
hangy 


#MMUIDX 
#$7F 


a 
SWITBLO,y 
swtst4 
swtst3 
SWTBLI,y 


sprint "MMU" or "LOU" 
;branch forever 


yset switches of the IOU/MMU to match Accumulato 


;branch if done setting switches 
;branch if setting switch to O-state 
selse get index to set switch to L 


IOSPACE-1,x ;set switch 


swtst2 


$C030 
a 


RSWTBL,y 
swtst6 
click 

a 

swtstS 
IOSPACE ,x 
swerr 
swest4 
IOSPACE,x 
swerr 
swest4 


a 


#L 
swtst2 


BIGLOOP 
#LOUIDX 
swtstl 


#0 
#LOUIDX+1 
bbits1 
$80 
SWCHTST 
#$A0 

#0 
$400,y 
$500,y 
$600,y 
$700,y 


jbranch always taken... 


snow verify the settings just made 
;branch if done this pass 
;branch if this switch no to be verified. 


;branch always 


;branch always 


;restore original value 
3 and IOU/MMU index 


;try next pattern 

jwas MMU just tested? 

;branch if IOU was just tested 
jelse, go test IOU. 

;branch always taken... 


;indicate switch error 
;set carry if LOU was cause 


;clear screen for success message 


€792:D0 
C794:AD 
€797:2D 
C79A:0A 
C79B:E6 
C79D:A5 
C79F:90 
C7A1:4C 
C7A4: 

C7A4:AD 
€7A47:A0 
C7A9:B9 
C7AC:99 
C7AF:88 
C7B0:10 
C7B2:30 
C7B4: 

C7B4: 

C7B4:53 
C€7B9:00 
C€7C9:00 
C€7D9:00 
C7EA: 

C7EA:D2 
C7FO:CD 


C7F6:D3 
C7FF: 
C7FF: 
C7FF: 
c800: 
c800: 
c800: 
c800:4C 
C803: 
C803: 
C803: 
C803: 
C803: 
C803: 
C803: 
C803: 
C803: 
C803: 
C803: 
C803: 
C803: 
C803: 
C803: 
C803: 


C7A4 
C6 


co 
c7 
c7A9 
C794 
C7 B4 
2B 29 
31 03 
31 04 
FF 13 
cD AO 
DS C9 
F3 F4 
C7FF 


0001 


co 


c803 


C€803:20 F4 CE 
C806:20 2A C8 
C809:20 2E CD 


6L¢e 


246 
247 
248 
249 
250 
251 
252 
253 
254 
255 
256 
257 
258 
259 
260 
261 
262 


264 
265 
266 
267 
268 
269 
270 


bne blp3 
blp4 LDA $c061 jtest for both Open and Closed Apple 
AND $C062 3 pressed 
asl a ;put result in carry 
INC $FF 
LDA $FF 
bee dquit 
jmp DIAGS 


lda TEXT 

ldy #8 

suc2 lda success,y 
sta SCREEN,y 
dey 

bpl suc2 

bmi bl p4 


dquit ;put success message on the screen 


j;loop forever 


setv equ * 
ntbl  dfb 83,67,43,41,7 


swtbl0 dfb $00,$89,$31,$03,$05,$09,$0b,$01,$00,$83,$51,$53,$55,$57,$0F, $OD 
swtbll dfb $00,$81,$31,$04,$06,$0A,$0C ,$02,$00,$84,$52,$54,$56,$58,$10, SOE 
rswtbl dfb $00,$11,$FF,$13,$14,$16,$17,$18,$00,$12,$1A,$1B,$1C,SID,S1E, $1F,$00 


MSB ON 
rmess asc “RAM zp" 
smess asc “MMULIOU" 
success asc "System OK” 
zzzend equ * 
INCLUDE C8SPACE 
DS C8ORG-*,0 ;pad to C800 
* 
* This entry point is only used by Pascal 1.0 
* 
JMP PINITI.0O ;PASCAL 1.0 LNIT 
* 
* BASIC initialization: 
* 
* This is called by the $C3 space only after a PR#3 or 
* the equivalent (a JSR $C300). 
* 
* It causes a copy of the $F8 ROM to be placed in the 
* language card if the language card.ds switched in and 
* the ID byte doesn't match. It sets up all the 
* screenhole variables to support its operation. If the 
* 80 column card is detected, it sets things up for 80 column 
* operation, else 40 column operation. Then it clears the 
* screen and prints the character that was in the accumulator 
* upon entry. 
* 
BASICINIT EQU * 


JSR COPYROM 
JSR C3HOOKS 
JSR DO40 


;lf LC in, copy F8 to it 
yout*$C307, in=$C305 
j;set full 40-col window 


C80C: Ad 
C80E:8D 
c8ll: 
C811: 
Cc8ll: 
€811:20 
C814:D0 
C816:06 
C818:8D 
C81B:8D 
C81E: 
C8LE: 
C81E: 
CB1E: 
C81E:8D 
C€821:20 
824: AC 
C827 :4C 
C82A: 
C82A:A9 
C€82C:85 
C82E:A9 
€830:85 
C832: 
C832: 
C832: 
C832:A9 
C834:85 
C836 :A9 
C838:85 
C83A:60 
C83B: 
C83B:E6 
C83D:DO 
C83F:£6 
C841:AD 
C844:10 
C846:8D 
C849:60 
C84A: 
C84A: 
CB4A: 
C84A: 
C84A: 
C84A: 
C84D: 

s 
84D: 
C84D:4c 
c850: 
C850: 
C850: 
c850: 
C850; 


ol 
FB 04 


90 CA 

08 CB8lE 
21 

01 co 

OD co 


C81E 
OF co 
90 CC 
78 0S 
7E C8 


07 
36 
C3 
37 


05 
38 
c3 
39 


4E 

02 «C841 
4F 

00 cO 

FS C¢83B 
10 co 


0003 
0000 


50 C3 


LDA #M.MOUSE 
STA MODE 


3init with mouse text off 
;Set BASIC video mode 
* 


* IS THERE A CARD? 
* 
JSR TESTCARD 
BNE CLEARIT 
ASL WNDWDTH 


;SEE IF CARD PLUGGED IN 
j=>IT's 40 
;SET 80-COL WINDOW 


STA SET80COL ;ENABLE 80 STORE 
STA SET8O0VID ; AND 80 VIDEO 
* 
* HOME & CLEAR: 
* 
CLEARIT EQU * 
STA SETALTCHAR ;SET NORM/INV LCASE 
JSR X.FF ;CLEAR IT 
LDY OURCH 3;set up cursor for store 
JMP BPRINT jalways print a character 
* 
C3HOOKS LDA #>BASICOUT ;set output hook first 
STA CSWL 
LDA #<CNOO 
STA CSWH 
* 
* C3IN is called by IN#0 if CSWH = #$C3 
* 
C3IN LDA #>BASICIN ;set input hook 
STA KSWL 
LDA #<CNOO 
STA KSWH 
RTS yexit with A=$C3 for IN#O stuff 
* 
GETKEY INC RNDL ;BUMP RANDOM SEED 
BNE GETK2 
INC RNDH 
GETK2 LDA KBD ;KEY PRESS? 
BPL GETKEY 3=>NOPE 
STA KBDSTRB ;CLEAR STROBE 
RTS 
* 
FEIT IOI I III II III IIR IAI IIIS AAI III AIA 


* 


* PASCAL 1.0 INPUT HOOK: 

* 
DS C8ORG+$4D-* ,0 ;pad to 1.0 hooks 
IFNE *-C80RG-$4D ;ERR IF WRONG ADDR 


FAIL 2,'C84D HOOK ALIGNMENT’ 
FIN 
JMP JPREAD 3=>GO TO STANDARD READ 


FRI III TIT IR TOT II III IAI TAI IOI IA IIR. 

* 

* CSETUP compensates for everything that the user 
* can do to change the cursor status: poke CV, CH, 
* OURCH, WNDWDTH. It updates the video firmware's 


Ooze 


C850: 
C850: 
C850: 
c850: 
C850:A5 
C852:8D 
C855: A4 
C857 :CC 
C85A:FO 
C85C:8C 
C85F:A5 
C861:18 
C862 :ED 
C865: BO 
C867: A0 
C869:8C 
C86C:AC 
C86F:60 
C870: 
C870: 
C870: 
c870: 
870: 
C870: 
c870: 
C870: 
c870: 
C870: 
C870: 
C870: 
C870: A4 
C872:18 
€873:B0 
C874: 
€874:38 
€875;8D 
€878:98 
€879:48 
C87A:8A 
C87B:48 
C87C: 
C87C:BO 
0000: 
C87E: 
C87E: 
C87E: 
C87E: 
C87E: 
C87E: 
C87E: 
C87E:20 
C881:AD 
C884:C9 
C886:D0 


FB 
24 
7B 
03 
7B 
21 


7B 
05 


7B 
78 


35 


FE 


7B 


SE 


50 
7B 
8D 
18 


05 
04 


05 


05 


05 
05 


06 


c8 
06 


C85F 


C86C 


C873 
C874 


c87c 
C8DC 
0000 


C8A0 


115 
116 


* versions of these values for its own use. 


* COPY USER'S CURSOR IF IT DIFFERS FROM 
* WHAT WE-LAST PUT THERE: 
* 
CSETUP LDA CV ;set up OURCV 
STA OURCV 
LDY CH 3GET IT 
cPY OLDCH 31S IT THE SAME? 
BEQ CS2 s=>YES, USE OUR OWN 
STY OURCH supdate our cursor 
cs2 LDA WNDWDTH scursor horizontal must not 
CLC jbe greater than window width 
SBC OURCH jif it is, then-put cursor 
BCS CS3 sat left edge of window 
Loy #0 
STY OURCH 
cs3 LDY OURCH jexit with Y = CH 
RTS 
* 
* BIN and BOUT are used when characters. are 
* input and output by the $F8 ROM while 80VID 
* is on. They cannot use the $C3 entry points 
* because that switches in the $C8 space, causing 
* possible conflict with other $C8 users. 
* These routines are only called by the $C100-$C2FF space. 
* 
* These entry points will only work if the card was 
* first initialized using a PR#3. 80 columns will not 
* work simply by turning on the 8NVID flag. 
* 
BOUT LOY SAVY1 ;load Y stuffed hy $F8 ROM 
CLC ;signal an output 
BCS * 3skip SEC 
ORG *-1 
BIN SEC ssignal an input 
STA CHAR 3Save the char 
TYA save Y 
PHA 
TXA tsave X 
PHA 
C8BASIC EQU * ;BASIC IN/OUT 
BCS BINPUT ;=>input a character 
TEST £QU 0 ;REAL VERSION 
LST ON,A,V 
INCLUDE BPRINT 
* 
* This is the place where characters printed using the 
* CSW hook are actually printed (or executed if they are 
* control characters). 
* 
BPRINT JSR CSETUP jsetup user cursor 
LDA CHAR 3GET CHARACTER 
cmp #$8D sIS IT C/R? 
BNE NOWAIT 3=>don't wait, OURCH ok 


C888 : AE 
C88B:10 
C88D:E0 
C88F:D0 
C891:2C 
C894:AE 
C897:10 
C899:EO 
C89B:FO 
C€89D:2¢ 
C8A0 229 
C8A2:C9 
C8A4: BO 
C8A6:20 
CBA9:4C 
CBAC: 

CBAC: 

CBAC: 

CBAC: 

C8AC:AD 
C8AF:20 
C8B2: 

CBB2: 

C8B2: 

C8B2:C8 
C8B3:8C 
C8B6:C4 
C8B8 :90 
C8BA:20 
C8BD: 

C8BD: 

C8BD: 

C8BD: 

C8BD:AD 
€8C0:29 
C8C2:8D 
C8C5: AD 
C8C8:2C 
C8CB:10 
C8CD:A9 
C8CF:85 
C8D1:8D 
C8D4 268 
C8D5:AA 
C8D6 368 
C807 :A8 
C8D8 : AD 
C8DB:60 
c8ne: 

C8DC: 

c8DC: 

C8DC: 

c8DCc: 

C8DC:A4 


7B 
38 


7B 
21 


5k 


7B 


24 


co 
C8A0 


c8Aa0 
co 
co 
C894 


C8A0 
co 


CBAC 
cA 
c8 


C8AC 
06 
CE 


05 


C8BD 
cB 


04 
04 
os 


co 
C8CF 


04 


06 


LDX . KBD ;1S KEY PRESSED? 
BPL NOWAIT 3NO 

CPX #$93 31S IT CTL-S? 
BNE NOWAIT 3NO, IGNORE IT 


BIT KBDSTRB  ;CLEAR STROBE 

KBDWAIT LDX KBD 3WAIT FOR NEXT KEYPRESS 
BPL KBDWAIT 
CPX #$83 ;IF CTL-C, LEAVE IT 


BEQ NOWAIT 3; IN THE KBD. BUFFER 

BIT KBDSTRB ;CLEAR OTHER CHARACTER 
NOWAIT AND: #$7F jdrop possible hi bit 

CMP #$20 31S IT CONTROL. CHAR? 

BCS BPNCTL 3=>NOPE 

JSR CTLCHARO ;execute CTL if M.CTL ok 

JMP CTLON 3=>enable ctl chrs 


* 
* NOT A CTL CHAR. PRINT IT, 
* 
BPNCTL EQU * 
LDA CHAR jget char (all 8 bits) 


JSR STORCHAR j;and display it 
* 
* BUMP THE CURSOR HORIZONTAL: 
* 
INY sbump it 
STY OURCH 3are we past the 
CPY WNDWDTH 3; end of the line? 
BCC CTLON 3=>NO, NO PROBLEM 
JSR X.CR ;¥ES, DO C/R 
* 
* M.CTL is set by RDCHAR and cleared here, after each 
* character-is displayed. 
* 
CTLON LDA MODE jenable printing: of control char: 
AND #255-M.CTL 
STA MODE 
BIORET LDA OURCH j;get newest cursor position 
BIT RD80VID 3 IN 80-MODE? 
BPL SETALL 3™>no, set other cursors 
LDA #0 ;pin CH to 0 for 80 columns 
SETALL STA CH 
STA OLDCH ;REMEMBER THE SETTING 
GETREGS PLA ; RESTORE 
TAX 
PLA 3X AND Y 
TAY 
LDA CHAR 
RTS ;RETURN TO BASIC 
INCLUDE BINPUT 


* 


* BASIC input..entry point called by entry point in the 
* $C3 space. »This is the way things normally happen. 
* 


BINPUT LDY CH 


LZe 


C8DE:AD 
C8E1:91 
CBE3:20 
C8E6:20 
C8E9:20 
C8EC:8D 
CBEF:20 
CB8F2:A8 
CBF3: 
C8F3: 
C8F3: 
C8F3: 
C8F3: 
CBF3: 
C8F3: 
C8F3: 
C8F3:AD 
C8F6:29 
C8F8:FO 
C8FA:CO 
C8FC:DO 
C8FE:AD 
€901:29 
C903:8D 
C906: 
C906 :CO 
C908 :FO 


-C9OA: 


C9OA: 
C90A: 
C90A:CO 
c90C : DO 
C90E:AC 
c911:20 
C914:09 
C916:8D 
C919:DO 
C91B: 
COLB: 
C91B: 
C91B: 
COLB: 
C9OLB: 
C91B: 
COLB: 
C91B: 
COLB: 
C9O1B: 
COLB: 
C91B: 
COLB: 
COLB: 
C91B: 
C91B: 


7B 
28 
50 


3B 
7B 
26 


FB 
08 
cB 
8D 


FB 
F7 
FB 


3B 
ll 


06 
c8 
CE 
c8 


06 
CE 


04 


c8c5 


c906 
04 


04 
c906 


C91B 


c8c5 


cE 


06 
c8c5 


LDA CHAR 
STA (BASL),Y 
JSR CSETUP Sget newest cursor 
B.INPUT JSR INVERT sinvert that char 
JSR GETKEY 3;GET A KEY 
STA CHAR ;SAVE IT 
JSR INVERT ;REMOVE CURSOR 
TAY 3preserve acce 
* 
* On pure input, an uninterpreted character code should 
* be returned. If M.CTL is set, however, escape functions 
* are enabled, and CTL-U causes the character under the 
* cursor to be picked up from the screen. 
* M.CTL is set whenever a character is requested using 
* RDCHAR in the $F8 ROM. 
* 
LDA MODE 3is escape mode enabled? 
AND #M.CTL 
BEQ BIORET }=>no,return 
cpy #$8D jwas it a CR 
BNE NOTACR ;™>nope, not a CR 
LDA MODE 
AND ‘#255-M.CTL ;else end of: line... 
STA MODE 5; disable escape 
NOTACR EQU * 
cPy #$9B 3;ESCAPE KEY? 
BEQ ESCAPING ;=>YES IT IS 
* 
* Not an escape sequence. Check for control-u. 
* 
cPY #$95 jis it~ control-U? 
BNE BIORET sno, return to caller 
LDY “ OURCH sget horizontal position 
JSR PICK sand pick up the char 
ORA #$80 jalways pick as normal 
STA CHAR ;save keystroke 
BNE BLORET 3=>(always) return to caller 
* 
* Start an escape sequence. If the next character 
* pressed is one of the following, it is executed. 
* Otherwise it is ignored. 
* 
* @ - home & clear 
* E - clear to end of line 
* F - clear to end of screen 
* I - move cursor up 
* J - move cursor left 
* K - move cursor right 
* M - move cursor down 
* 4 - enter 40 column mode 
* 8 - enter 80 column mode 
* CTL-D- disable the printing of control characters 


* CTL-E- enable the printing of control characters 
* CTL-Q- quit (PR#O0/IN#O) 


C9LB: 
C91B: 
COLB: 
CO1B: 
C91B:20 
C91E:20 
€921:20 
€924:20 
C927:29 
€929:A0 
C92B:D9 
C92E:FO 
C930 388 
€931:10 
C933:30 
C935: 
C935: 
C935: B9 
C938:29 
C93A:20 
C93D:B9 
€940:30 
€942:10 
C944: 
C944: 
C944: A8 
€945:AD 
C948:C0 
C94A:D0 
C94C:20 
CI4F:A9 
C951:8D 
C954:4C 
C957: 
€957:CO 
€959:DO 
C95B:29 
c95D:8D 
€960:4C 
C963: 
€963:C0 
€965:D0 
C967:09 
C969: D0 
C96B: 
C96B: 
C96B: 
C96B: 
C96B: 
C96B: 
CO6B: 
C96B: 
C96B:0C 
c96C:1C 


Bl 
3B 
c4 
14 
10 


7c 
05 


F8 
OF 
6B 
7F 


6B 


FB 
11 
OB 
4D 
98 


cs 
05 
DE 
FB 
E6 


04 
F9 


F2 


c91B 
CE 
c8 
CE 
CE 


cy 
c935 


c92B 
C944 


6935 
c9 


CA 

c9 
C91B 
C8E6 
C944 

04 


c957 
cD 


06 

cs 
C963 

04 

c8 
c960 


c95D 


C96B 


115 


* The four arrow keys (as IJKM) 


ESCAPING EQU 


ESC2 


ESc3 


* 
ESCSPEC 


ESCSP1 


ESCSP2 


“ ESCSP3 


* 
ESCSP4 


MSB 


JSR 
JSR 
JSR 
JSR 
AND 
LDY 
CMP 
BEQ 
DEY 
BPL 
BMI 


EQU 
LDA 
AND 
JSR 
LDA 
BML 
BPL 


EQU 
TAY 
LDA 
CPY 
BNE 
JSR 
LDA 
STA 
JMP 


cPY 
BNE 
AND 
STA 
JMP 


CPY 
BNE 
ORA 
BNE 


OFF 

* 

ESCON ;ESCAPE CURSOR ON 
GETKEY ;GET ESCAPE FUNCTION 
ESCOFF ;REPLACE ORIGINAL CHARACTER 
- UPSHFT supshift the char 

#S7F ;DROP HI BIT 

#ESCNUM-1 ;COUNT/ INDEX 

ESCTAB,Y ;1S IT A VALID ESCAPE? 
ESC3 ;=>YES 

ESC2 ;TRY ‘EM ALL... 

ESCSPEC j=>MAYBE IT'S A SPECIAL ONE 
* 

“ESCCHAR,Y ;GET CHAR TO "PRINT" 
#S7F ;DROP HI BIT (FLAG) 
CTLCHAR ;EXECUTE IT 

ESCCHAR,Y ;GET FLAG 

ESCAPING ;=>STAY IN ESCAPE MODE 
B. INPUT 3;=>QUIT ESCAPE. MODE 

* 

;put char here 

.MODE 3S0 we can put this here 
#511 swas it Quit? 

ESCSP1 ;=>no 

X.NAK sdo the quitting stuff 
#$98 smake it look like 

CHAR 5;CTL-X was pressed 
BIORET 5=>quit the card forever 
#505 jwas it CTL-E for enable 
ESCSP4 3;=>no 


#255-M.CTL2 ;yes, enable ctl chars 


MODE j;Save new mode 

B.INPUT 3;=> exit escape mode 
#$04 j;was it CTL-D for disable 
ESCSP3 j=>no, exit escape mode 
#M.CTL2 3disable. ctl chars 

ESCSP2 5=> exit escape mode 


This table contains the control characters which, 
when executed, carry out the escape functions. If 


escape mode should not be exited after execution of 
the character. 


* 
* 
* 
* the high bit of the character is set, it means that 
* 
* 
* 


ESCCHAR FQU 


DFB 
DFB 


* 


$oc ;@: FORMFEED 
$ic 3A: FS 


oZE 


C96D:08 
C96E:0A 
C96F:1F 
c970:1D 
€971:08 
C972:9F 
C973:88 
C974:9C 
C975:8A 
c976:11 
€977:12 
C978:88 
C979:8A 
CO7A:9F 
C97B:9C 
c97c: 

c97c: 

cg7c: 

€97C:40 
C97D:41 
C97E:42 
C97F:43 
C980 :44 
€981:45 
C982:46 
C€983:49 
C984 248 
C985:4B 
C986:4D 
C987:34 
C988 338 
c989:08 
C98A:0A 
C98B:0B 
c98c:15 
C98D: 

c98D: 

c98D: 

C98D: 

c98D: 

C98D:2C 
€990:30 
C992:A9 
€994:8D 
C997 :8D 
C99A:8D 
C99D:8D 
C9A0:CD 
C9A3:60 
C9A4: 

C9A4: 

C9A4: 

C9A4: 

C9A4:CA 


c97C 


001k 


13 co 

11 C9A3 
EE 

05 co 

03 co 

00 Oc 

00 08 

00 Oc 


cB CD C9 


116 
117 
118 
119 
120 
121 
122 
123 
124 
125 
126 
127 
128 
129 
130 
131 
132 
133 
134 
135 
136 
137 
138 
139 
140 
141 
142 
143 
144 
145 
146 
147 
148 
149 
150 
151 
152 
153 
154 
155 
156 
157 
158 
159 
160 
161 
162 
163 
164 
165 
166 
167 
168 
169 






DFB $08 ; 
DFB $0A 3 
DFB $1F : 
DFB $1D ; 
DFB $0B ; 
DFB $1F+$80 ;1: US (STAY ESC) 
DFB $08+$80 3 BS (STAY ESC) 
DFB $1C+$80 ; FS (STAY ESC) 
DFB $0A+$80 ; LF (STAY ESC) 
DFB $11 34 :DCl 
DFB $12 38 :DC2 
DFB $08+$80 ;<-:BS (STAY ESC) 
DFB $0A+$80 3DN:LF (STAY ESC) 
DFB $1F+$80 ;UP:US (STAY ESC) 
DFB $1C+$80 ;->:FS (STAY ESC) 
* 
MSB OFF shigh bit already masked 
ESCTAB EQU * 
Asc '@’ 
asc ‘A’ ;HANDLE OLD ESCAPES 
asc 'B' 
ASC 'C' 
asc '‘D' 
ASC 'E' 
ASC ‘F! 
asc: ‘I' 
Asc ‘J’ 
asc 'K' 
asc 'M’ 
asc °4' 
asc ‘8° 
DFB $08 ;LEFT ARROW 
DFB SOA 3DOWN ARROW 
DFB $0B ;UP = ARROW 
DFB $15 ;RITE ARROW 
ESCNUM EQU *-ESCTAB 
MSB ON 
* 
* Tack on diag 128K test here 
* 
STAUX BIT RDRAMRD jaux done yet? 
BMI XSTAUX 3=>yes, exit 
LDA #SEE jget test pattern 
STA WRCARDRAM ;write AUX RAM 
STA RDCARDRAM ;read AUX RAM 
STA $c00 ;test this byte 
STA $800 sand this is 1K off 
CMP $CO0O shas $COO been updated? 
XSTAUX RTS 3check in main diags. 
* 
* ESCOUT used by ESCFIX in SCl page 
* 
MSB ON 
ESCOUT ASC 'JKMI' ;The arrows 


C9A8: 
C9AB: 
c9A8: 
C9A8: 
C9A8: 
C9AB: 
C9AA: 

s 
C9AA: 
C9AA:AD 
C9AD:4C 
COBO: 
C9BO: 
c9BO: 
Cc9BO: 
C9BO: 
C9BO: 
C9BO: 
C9BO:A9 
C9B2:D0 
COB4: 
C9B4:A9 
C9B6: 
Cc9B6: 
C9B6 248 
C9B7: 
C9B7: 
C9B7: 
C9B7:20 
C9BA: FO 
C9BC 368 
C9BD:A2 
C9BF:60 
c9co: 
c9co: 
C9CO:68 
c9C1:8D 
c9C4:8D 
C9C7:8D 
C9CA:8D 
c9CD:20 
C9D0 :20 
C9D3:4¢ 
C9D6: 
C9D6: 
C9D6: 
C9D6: 
C9D6: 
c9D6: 
C9D6: 
C9D6:20 
C9D9:20 
C9DC:29 
C9ODE:8D 


7B 
56 


83 


81 


90 
04 


09 


FB 
01 
oD 
OF 


90 
lF 


D4 
3B 


7B 


170 


MSB OFF 


INCLUDE PASCAL 
RIERA RRA REIKI RRERARRIERIIAR IAAI. 


2 * PASCAL 1.0 OUTPUT HOOK: 


0002 
0000 


06 
c3 


c9BO O16 


C9B6 18 
coB4 «19 


C9B6 = 22 


CA 27 
c9coO— 28 


c9co 33 


04 35 
co 36 
co 37 
co 38 
CE 39 
cc 40 
cA 41 


c9D6 «= 48 
CE 49 
c8 50 


06 52 


REAEREKERREERERERERREREREEERRRKRRRRA RARER 
DS C8ORG+$1AA-*,0 
IFNE *-C8ORG-$1AA 
FAIL 2,'C9AA HOOK ALIGNMENT’ 
FIN 
LDA CHAR ;GET OUTPUT CHARACTER 
JMP JPWRITE  ;=>USE STANDARD WRITE 


RREKKKEREKRRAERERERER EERE ERERRERERERE 
* 
REERERRKKREKRERRRRERRERERERRERERERERRERER 
* PASCAL INITIALIZATION: 
* Disable printing of mouse text 
FEA TTI IIR TAIT AIT I ITI I IO AIA. 
PINIT1.0 EQU * 
LDA #M.PASCAL+M.PAS1 .0+M.MOUSE 

4 BNE PINIT2 ?=>always 

PINIT EQU * 


LDA #M.PASCAL+M.MOUSE ;SAY WE'RE 
* 
PINIT2 RQU * 
PHA ;save version ID 
* 
* SEE IF THE CARD'S PLUGGED IN: 
* 
JSR TESTCARD ;I1S IT THERE? 
BEQ PIGOOD ;=>YES 
PLA ;discard ID byte 
LDX #9 ;LORESULT="NO DEVICE’ 
RTS 


* 
PIGOOD £QU * 
PLA jget version ID 
STA MODE 3; and save it 
STA SET80COL ;ENABLE 80 STORE 
STA SET80VID ; AND 80 VIDEO 
STA SETALTCHAR ;NORM+INV LCASE 


JSR PSETUP set window and cursor 
JSR X.FF ;HOME & CLEAR IT 
JMP DOBASL 3fix OLDBASL/H, display cursor, exit 


RHR RKKIR HAIR IARI RARE IAIKRIAIIARAR 


* PASCAL INPUT: 
* 


* Character always returned with high bit clear. 
* 


= RII III IIR I III IIR III IIIA ISIS II III IAAI IAA. 
PREAD EQU * 
JSR PSETUP ;SETUP ZP STUFF 
JSR GETKEY 3GET A KEYSTROKE 
AND #S$7F ;DROP HI BIT 
STA CHAR ;SAVE THE CHAR 


€ze 


C9E1:A2 
C9E3:AD 
C9E6:29 
C9E8:FO 
C9EA:A2 
C9EC: 

C9EC: 

C9EC: AD 
C9EF:60 
C9FO: 

C9FO: 

C9FO: 

C9FO: 

C9FO: 

C9FO: 

C9FO: 

C9FO:29 
COF2:AA 
C9F3:20 
COF6:A9 
C9F8:2C 
C9OFB:DO 
COFD:8A 
C9OFE:2C 
CA01:FO 
CA03: AC 
CA06:24 
CA08: 10 
CAQA:09 
CA0C:20 
CAOF:C8 
CALO:8C 
CA13:C4 
CA15:90 
CAL7:A9 
CAL9:8D 
CA1C:20 
CAILF:A5 
CA21:8D 
CA24:A5 
CA26:8D 
CA29:20 
CA2C3A2 
CA2E:60 
CA2F: 

CA2F: 

CA2F: 

CA2F:20 
CA32:8A 
CA33:38 
CA34:E9 
CA36:2C 
CA39:30 
CA3B: 


00 
FB 
02 
02 
c3 


7B 


7F 


08 
FB 
32 


2E 
50 
7B 
32 
02 
80 
70 


7B 
21 


00 
7B 
D8 
28 
7B 
29 
FB 
iF 
00 


1F 


20 
FB 
30 


04 


C9EC 


C9EC 
06 


C9FO 


CE 


04 
CA2F 


CA 
cAS3 

05 
CAOC 

CE 

05 
CALF 


os 
cB 


07 


07 
CE 


CE 


06 
CA6B 


53 Lbx #0 ; IORESULT='GOOD' 

54 LDA MODE ;ARE WE IN 1.0-MODE? 

E>) AND #M.PAS1.0 

56 BEQ PREADRET2 ;=>NOPE 

57 LDX #<CNOO 3YES, RETURN CN IN X 

58 * 

59 PREADRET2 EQU * 

60 LDA CHAR s;RESTORE CHAR 

61 RTS 

62 * 

63 * PASCAL OUTPUT: 

64 * Note: to be executed, control characters must have 
65 * their high bits cleared. All other characters are 
66 * displayed regardless of their high bits. 

67 * 

68 PWRITE EQU * 

69 AND #S7F 3;clear high bits 

70 TAX 3;save character 

rau JSR PSETUP ;SETUP ZP STUFF, don't set ROM 
72 LDA #M.GOXY 3;ARE WE DOING GOTOXY? 

73 BIT MODE 

74 BNE GETX 3=>Doing X or Y? 

75 TXA snow check for control char 
76 BIT PRTS sis it control? 

77 BEQ PCTL 3=>yes, do control 

78 LDY OURCH sget horizontal position 

79 BIT INVFLG j;check for inverse 

80 BPL PWRI1 jinverse, go store it 

81 ORA #$80 

82 PWRI JSR STORIT snow store it (erasing cursor) 
83 INY 5 INC CH 

84 STY OURCH 

85 CPY WNDWDTH 

86 BCC DOBASL 

87 LDA #0 ;do carriage return 

88 STA OURCH 

89 JSR X.LF sand linefeed 

90 DOBASL LDA BASL 3save BASL for pascal 

91 STA OLDBASL 

92 LDA BASH 

93 STA OLDBASH 


94 PWRITERET JSR PASLNV 


95 PRET LDX 
96 PRTS RTS 


97 *& 
98 * 
99: * 
100 GETX JSR 
101 TXA 
102 SEC 
103 SBC 
104 BIT 
105 BMI 
106 * 


;display new cursor 
#50 sreturn with no error 


HANDLE GOTOXY STUFF: 


PAS INV jturn off cursor 
;get character 

#32 ;MAKE BINARY 

XCOORD jdoing X? 

PSETX s=>yes, set it 


CA3B: 

CA3B: 

CA3B:8D 
CA3E:85 
C€A40:20 
CA43:AD 
CA46:8D 
CA49:A9 
CA4B:2D 
CA4E:8D 
CA51:D0 
CA53: 

CA53:20 
CA56:8A 
CA57:C9 
CAS9: FO 
CA5B:20 
CASE: 4C 
CA61: 

CA61: 

CA61: 

CA61: 

CA61:A9 
CA63:0D 
CA66:8D 
CA69 = AD 
CA6B:8D 
CA6E:4C 
CA71: 

CA7L: 

CA71:AA 
CA72:A5 
CA74:A0 
CA76:E0 
CA78:FO 
CA7A:4A 
CA7B:90 
CA7D:4A 
CA7E:4A 
CA7F:09 
CA81:88 
CA82:DO 
CA84 :C8 
CA85 388 
CA86:DO 
CA88 :60 
CA89: 

CA89: 

CA89: 

CA89: 

CA89: 

CA89: 

CA89:20 
CA8C : DO 


1F 
1E 


D6 
1F 


20 


FA 


F2 


B7 
02 


05 
CA 
05 
04 
04 


CE 


04 
04 


06 
CA 


F8 


CAIF 


CA61 
CA 
CA 


CA61 


CA71 


CA85 


CA85 


CA7E 


CA7A 


CA89 


CcA90 


107 
108 
109 
110 
ill 
112 
113 
114 
115 
116 
117 
118 
119 
120 
121 
122 
123 
124 
125 
126 


* Set Y and do the GOTOXY 
* 
GETY STA OURCV 
STA CV 
JSR BASCALC scale base addr 
LDA XCOORD 
STA OURCH 3;set cursor horizontal 
LDA #255-M.GOXY ;turn off gotoxy 
AND MODE 
STA MODE 
BNE DOBASL ;=>DONE (ALWAYS TAKEN) 
* 
PCTL JSR PASINV sturn off cursor 
TXA sget char 
CMP #S1E jis it gotoXY? 
BEQ STARTXY ;=>yes, start it up 
JSR CTLCHAR ;EXECUTE IT IF POSSIBLE 
JMP DOBASL :=>update BASL/H, cursor, exit 
* 
* START THE GOTOXY SEQUENCE: 
* 
STARTXY EQU * 
LDA #M.GOXY 
ORA MODE turn on gotoxy 
STA MODE 
LDA #SFF ;set XCOORD to -1l 
PSETX STA XCOORD sset X 
JMP PWRITERET ;=>display cursor and exit 
INCLUDE SUBS1 
DOMN EQU * 
TAX ;SAVE IT 
LDA BAS2L ;GET OPCODE AGAIN 
Lpy #$03 
CPX #$8A 
BEQ MNNDX3 
MNNDX] LSR A 
BCC MNNDX3 ;FORM INDEX INTO MNEMONIC TABLE 
LSR A 
MNNDX2 LSR A s 1) 1XXX1010 => 00101XxXx 
ORA #$20 3 2) XXXYYYO] => OO1L1LIXxx 
DEY 3; 3) XXxYYYLO => 00110XxXx 
BNE MNNDX2 3 4) XXXYY1L00 => 00100Xxx 
INY 3 5) XXXXXO00 => OOOXXXXX 
MNNDX3 DEY 
BNE MNNDXI 
RTS 
* 
* Switch in slot 3, then test for a ROM card. 
* If none found, test for 80 column card, 
* else return with BNE. 
* 
TSTROMCRD EQU * 
JSR TSTROM 3;test for ROM card 
BNE TESTCARD ;=>no ROM, check for 80 column card 


vce 


CA8E:C8 
CA8F :60 
CA90: 
cA90: 
cA90: 
cA90: 
cag90: 
CA90: 
cAg90: 
CA90: 
cAg90: 
CA90: 
cago: 
CA90:AD 
CA93:0A 
CA94:A9 
CA96:2C 
CA99:8D 
CA9C:08 
CA9D:8D 
CAAO: AC 
CAA3:8D 
CAA6: AD 
CAA9:8C 
CAAC :28 
CAAD: BO 
CAAF :8D 
CAB2: 
CAB2 330 
CAB4 :8D 
CAB7: 
CAB7:C9 
CAB9 :60 
CABA: 
CABA: 
normal 
CABA: 
CABA: 
CABA:48 
CABB:4A 
CABC :29 
CABE:09 
CACO :85 
CAC2 768 


CAC3:29 - 


CAC5:90 
CAC7 :69 
CAC9:85 
CACB:0A 
CACC:0A 
CACD:05 
CACF:85 
CAD1:60 
CAD2: 


monitor ROM 


cago 


CAB2 


CAB2 

CAB7 
co 

CAB7 


CABA 


26 INY ;make BNE for return 
27 RTS i 


28 * 

QQ RRAHRREAEREER ERR RERERRRRRREAERRRRRRERER 

30 * NAME : TESTCARD 

31 * FUNCTION: SEE IF 80COL CARD PLUGGED IN 

32 * INPUT : NONE 

33 * OUTPUT +: ‘BEQ' IF CARD AVAILABLE 

34 * : "BNE' IF NOT 

35 * VOLATILE: AC,Y 

36 RERERERERERKAERKKKARKKKKAKKKK KKK KK 

37 * 

38 TESTCARD EOU * 

39 LDA RDPAGE2 ;REMEMBER CURRENT VIDEO DISPLAY 
40 ASL A ; IN THE CARRY 

41 LDA #$88 ;USEFUL CHAR FOR TESTING 
42 BIT RD80COL ;REMEMBER VIDEO MODE IN 'N' 
43 STA SET80COL ;ENABLE 80COL STORE 

44 PHP ;SAVE 'N’ AND 'C' FLAGS 
45 STA TXTPAGE2 ;SET PAGE2 

46 LDY $0400 3GET FIRST CHAR 

47 STA $0400 sSET TO A '** 

48 LDA $0400 3;GET IT BACK FROM RAM 
49 STy $0400 ;RESTORE ORIG CHAR 

50 PLP ;RESTORE ‘N' AND 'C' FLAGS 
51 BCS STAY2 ;STAY IN PAGE2 

52 STA TXTPAGEL ;RESTORE PAGE] 

53 STAY2 EQU * 

54 BMI STAY80 3=>STAY IN 80COL MODE 
55 STA CLR80COL ;TURN OFF 80COL STORE 
56 STAY8O EQU * 

57 CMP #$88 3;WAS CHAR VALID? 

58 RTS ;RETURN RESULT AS BEQ/BNE 
59 * 

60 * Do the 

BASCALC 

61 * 

62 BASCALC EQU * 

63 PHA 

64 LSR A 

65 AND #$03 

66 ORA #$04 

67 STA BASH 

68 PLA 

69 AND #$18 

70 BCC BSCLC2 

71 ADC #$7F 

72 BSCLC2 STA BASL 

73 ASL A 

74 ASL A 

75 ORA BASL 

76 STA BASL 

77 RTS 

78 * 


CAD2: 
CAD2: 
CAD2: 
CAD2: 
CAD2: 
CAD2: 
CAD2: 
CAD2: 
CAD2: 
CAD2: 
CAD2 :2C 
CAD5 :50 
CAD6: 
CAD6: 
CAD6: 
CAD6: 
CAD6: 
CAD6: 
CAD6: 
CAD6: 
CAD6: 
CAN6: 
CAD6: 
CAD6: 
CAD6 : BB 
CAD7 :8D 
CADA:48 
CANB:98 
CADC:48 
CADD: 
CADD:AC 
CAEO :CO 
CAE2:90 
CAE4:B9 
CAE7 : FO 
CAE9 350 
CAEB: 
CAEB: 
$ 
CAEB: 
CAEB: 30 
CAED: 
CAED: 
CAED:8D 
CAFO: AD 
CAF3:29 
CAF5: FO 
CAF7: 
CAF7: ° 
CAF7 :38 
CAF8: BO 
CAFA: 
CAFA:AD 
CAFD: 


06 CB 

FE CADS 
CAD6 

7B 07 

7B 07 

05 

13° CAF7 

B4 CB 

OE CAF7 

12. CAFD 
0000 

10 CAFD 

7B 07 

FB 04 

28 

03 CAFA 
CAF7 

09 = cBO3 

7B 07 
CAFD 


106 
107 
108 
109 
110 
lll 
112 
113 
114 
415 
116 
117 
118 
119 
120 
121 
122 
123 
124 
125 
126 
127 
128 
129 
130 
131 
132 


RRRERERRERERIERERERRERERERERRERRERARIARARK 


* NAME : 
* FUNCTION: 
* INPUT 
* OUTPUT 
* 

* VOLATILE: 
* CALLS : 


CTLCHARO 

Execute CTL char if M.CTL=0 
AC=CHAR 

‘BCS' if not executed 

"BCC' if executed 

NOTHING 

MANY THINGS 


RRA RIERA RIRERERIREREREEAERAERREREEARAR 


CTLCHARO BIT SEVI1 3set V (use M.CTL) 


BYC 
ORG 
* 


* gskip CLC 
*-1 


ERERRERRERERERERERERKE AREER EREREREKARKAKK 


NAME : 
FUNCTION: 
INPUT 
OUTPUT 


VOLATILE 
CALLS : 


+e ee 


CTLCHAR 

Always execute CTL char 
AC=CHAR 

"BCS' if not executed 
"BCC' if ctl executed 
NOTHING 

MANY THINGS 


REKRRKRERERRERREREEERERARERERERRERERERERER 


* 
CTLCHAR CLV 


sclear V (ignore M.CTL) 


STA TEMPI ;TEMP SAVE OF CHAR 
PHA ;SAVE AC 
TYA 3;SAVE Y 
PHA 
* 
LDY TEMP] ;GET CHAR IN QUESTION 
CcPY #S05 31S IT NUL..EOT? 
BCC CTLCHARX ;=>YES, NOT USED 
LDA CTLADH-5,Y ;Get high byte of address 
BEQ CTLCHARX ;=>ctl not implemented 
BYC CTLGOO ;=> CLTCHAR: always execute 
* 
DO TEST 
BPL CTLGOO 5=>CR,BEL,LF,BS always done 
ELSE 
BMI CTLGOO 3;=>CR,BEL,LF,BS always done 
FIN 
* 
STA TEMP1 ;save high byte of address 
LDA MODE 3if control chars 
AND #M.CTL+M.CTL2 ;are enabled 
BEQ CTLGO 3=>then go do them 
* 
CTLCHARX EQU * 
SEC ;SAY 'NOT CTL' 
BCS CTLRET 3=>DONE 
* 
CTLGO LDA TEMP] sget address back 
CTLGOO EQU * 


Sze 


CAFD: 
$s 
CAFD: 
CAFD:09 
CAFF: 
CAFF:20 
CBO2: 
CBO2:18 
CBO3: 
CBO3 :68 
CBO4: As 
CBOS5:68 
CB06:60 
CBO7: 
CBO?: 
CBO7 348 
CBO8:B9 
CBOB:48 
CBOC :60 
CBOD: 
CBOD: 
CBOD: 
CBOD: AD 
CB10:10 
CBL2:29 
cB14:8D 
CB17:60 
CB18: 
CB18: 
CB18: 
CBL8: 
CB18:AD 
CB1B:10 
CBLD:09 
CB1F:DO 
CB21: 
CB21: 
CB21: 
CB21: 
CB21:A9 
CB23:20 
CB26:A0 
CB28:A9 
CB2A:20 
CB2D:AD 
CB30:88 
CB31:D0 
CB33:60 
CB34: 
CB34: 
CB34:38 
CB35:48 
CB36:E9 
CB38:D0 


0000 

80 

07 CB 
CBO3 
CBO7 

99 CB 

FB 04 

05 CBI? 

EF 

FB 04 

FB 04 

FA CB17 

10 

F3CB14 
cB21 

40 

34 CB 

co 

oc 

34 CB 

30 co 

F5  CB28 
CB34 

ol 

FC B36 


133 
134 
135 
136 
137 
138 
139 
140 
141 
142 
143 
144 
145 
146 
147 
148 
149 
150 
151 
152 
153 
154 
155 
156 
157 
158 
159 
160 
161 
162 
163 
164 
165 
166 
167 
168 
169 
170 
171 
172 
173 
174 
175 
176 
177 
178 
179 
180 
181 
182 
183 
184 
185 
186 


DO TEST 
AND #$7F 3for test, hi bit clear 
ELSE 
ORA #$80 shi bit always set 
FIN 
JSR CTLXFER ;EXECUTE SUBROUTINE 
* 
cLC 3;SAY ‘CTL CHAR EXECUTED’ 
CTLRET EQU * 
PLA ;RESTORE 
TAY ;¥ 
PLA 3; AND AC 
SEVL RTS 
* 
CTLXFER EQU * 
PHA ;PUSH ONTO STACK FOR 
LDA CTLADL-5,Y ; TRANSFER TRICK 
PHA ‘ 
RTS ;XFER TO ROUTINE 


* 


* Turn cursor on for Pascal only 
* 


X.CUR.ON LDA MODE ;get mode byte 


BPL CURON.X 3™>not pascal, don't do it 
AND #255-M.CURSOR ;clear cursor bit 
SAVCUR STA MODE 3save it 
CURON.X RTS jand exit 


* 


* Turn cursor off for Pascal only. 

* Cursor is not displayed during call. 

* 

X.CUR.OFF LDA MODE ;get mode byte 
BPL CURON.X 3=>not pascal, don't do it 
ORA #M.CURSOR ;turn on cursor bit 
BNE SAVCUR ;Save and exit 

* 


* EXECUTE BELL: 

* 

X-BELL EQU * 
LDA #S40 
JSR WAIT 
LpY #$cO 

BELL2 LDA #$0C 
JSR WAIT 
LDA SPKR . 
DEY 
BNE BELL2 
RTS 


;RIPPED OFF FROM MONITOR 


WAIT EQU * 
SEC 

WAIT2 PHA 

WAIT3 spc #1 
BNE WAIT3 


;RIPPED OFF FROM MONITOR ROM 


CB3A:68 
CB3B:E9 
CB3D:DO 
CB3F:60 
CB40: 
CB40: 
CB40: 
CB40: 
CB40:CE 
CB43:10 
CB45:A5 
CB47 :8D 
CB4A:CE 
CB4D:20 
cB50: 
CB50:60 
CB51: 
CBS1: 
CB51: 
CBS1: 
CB51:A9 
CB53:8D 
CB56: AD 
CB59:30 
CB5B:20 
CBSE: 
CB5E:60 
CBSF: 
CBSF: 
CBSF: 
CBSF: 
CB5F:A5 
CB61:85 
CB63:A9 
CB65:8D 
CB68:4C 
CB6B: 
CB6B: 
CB6B: 
CB6B: 
CB6B:EE 
CB6E:AD 
CB71:C5 
CB73:90 
CB75:20 
CB78: 
CB78: 
CB78:60 
CB79: 
CB79: 
CB79: 
CB79:A5 
CB7B:C5 
CB7N:BO 


01 
F6 


7B 
OB 
21 
7B 
7B 
79 


00 


FB 
03 


22 
25 
1E 


cB35 


CB40 
05 
CB50 


05 
05 


cB 
CB50 


CcB51 
0s 
04 
CBSE 


cB 
CBSE 


CBSF 


05 
cD 


CB6B 


05 


cB78 
cB 


cB78 


CcB9D 


187 
188 
189 
190 
191 
192 
193 
194 
195 
196 
197 
198 
199 
200 
201 
202 
203 
204 
205 
206 
207 
208 
209 
210 
211 
212 
213 
214 
215 
216 
217 
218 
219 
220 
221 
222 
223 
224 
225 
226 
227 
228 
229 
230 
231 
232 
233 
234 
235 
236 
237 
238 
239 
240 


PLA 
sBc #1 
BNE WAIT2 
RTS 

* 


* EXECUTE BACKSPACE: 
* 


X.BS EQU * 


DEC OURCH ;BACK UP CH 

BPL BSDONE 3=>DONE 

LDA WNDWDTH ;BACK UP TO PRIOR LINE 

STA OURCH ;SET CH 

DEC OURCH 

JSR X.US ;NOW DO REV LINEFEED 
BSDONE EQU * 

RTS 


* 


* EXECUTE CARRIAGE RETURN: 
* 
X.CR  EQU * 
LDA #0 ;BACK UP CH TO 
STA OURCH 3 BEGINNING OF LINE 


LDA MODE ;ARE WE IN BASIC? 

BMI X.CRRET 3=> Pascal, avoid auto LF 

JSR X.LF ;EXECUTE AUTO LF FOR BASIC 
X.CRRET EQU * 

RTS 


* 


* EXECUTE HOME: 
* 


X.EM EQU * 


LDA WNDTOP 

STA CV 

LDA #0 

STA OURCH 3;STUFF CH 

JMP VTAB 3set base for OURCV 


* 


* EXECUTE FORWARD SPACE: 
* 


X.FS EQU * 


INC OURCH 3; BUMP CH 

LDA OURCH ;GET THE POSITION 
CMP WNDWDTH ;OFF THE RIGHT SIDE? 
BCC X.FSRET 3=>NO, GOOD 

JSR X.CR 3™>YES, WRAP AROUND 


* 


X.FSRET EQU * 
RTS 

* 

* EXECUTE REVERSE LINEFEED: 

* 

X.US LDA WNDTOP 
CMP CV 
BCS X.USRET 


sare we at top? 


3=>yes, stay there 


9ZE 


CB7F:C6 
CB81:4C 
CB84: 

CB84: 

CB84: 

CB84: 

CB84:AD 
CB87:10 
CB89:29 
CB8B:A0 
CB8D: DO 
CB8F: 

CB8F: 

CB8F: 

CB8F: 

CB8F:AD 
cB92:10 
CB94:09 
CB96:A0 
CB98:8D 
CB9B:84 
CB9D:60 
CB9E: 

CB9E: 

CB9E:0C 
CB9F:17 
CBAO:20 
CBAL:3F 
CBA2:00 
CBA3:D7 
CBA4:73 
CBA5:8F 
CBA6:50 
CBA7 :83 
CBA8:8E 
CBA9:00 
CBAA:E9 
CBAB: FB 
CBAC :00 
CBAD:00 
CBAE:4C 
CBAF:D3 
CBBO:EA 
CBB1:3C 
CBB2:5E 
CBB3:95 
CBB4:43 
CBB5:6A 
CBB6:99 
CBB7 :00 
CBB8:78 
CBB9: 

CBB9: 

CBB9:4B 


25 
FE 


FB 
02 


FF 
09 


cD 


04 


04 


04 


CB84 


CB8B 


CB98 


CB8F 


CB96 


CB9E 


CBB9 


241 
242 
243 
244 
245 
246 
247 
248 
249 
250 
251 
252 
253 
254 
255 
256 
257 
258 
259 
260 
261 
262 
263 
264 
265 
266 
267 
268 
269 
270 
271 
272 
273 
274 
275 
276 
277 
278 
279 
280 
281 
282 
283 
284 
285 
286 
287 
288 
289 
290 
291 
292 
293 
294 


DEC 


JMP 
* 


cv 3;else go up a line 
VTAB sexit thru VIAB (update OURCV) 


* EXECUTE "NORMAL VIDEO" 
* 


X.SO EQU 
LDA 
BPL 
AND 
X.SO1 LDY 


BNE 
* 


* 


MODE ;SET MODE BIT 
X.SO1 sdon't set mode for BASIC 
#255-M.VMODE ;SET 'NORMAL' 

#255 


STUFFINV ;(ALWAYS) 


* EXECUTE “INVERSE VIDEO" 


* 

X.ST EQU 
LDA 
BPL 
ORA 

X.SIL LDY 

STUFFINV STA 
STY 

X.USRET RTS 

* 


CTLADL EQU 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
OFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
* 


CTLADH EQU 


DFB 


* 
MODE ;SET MODE BIT 

X.SIL jdon'’t set mode for BASIC 
#M.VMODE ;SET 'INVERSE' 

#127 

MODE ;SET MODE 

INVFLG ;STUFF FLAG TOO 


* 
#>X.CUR.ON-1 ;ENQ 
#>X.CUR.OFF-1 ; ACK 
#>X.BELL-1 ; BEL 
#>X.BS-1 BS 

0 3HT 
#>X.LF-1 =; LF 
#>X.VT-1 3VT 
#>X.FF-1 =; FF 
#>X.CR-1 3CR 
#>X.S0-1 380 
#>X.SI-1 ;SI 

0 ;DLE 
#>X.DC1-L DCL 
#>X.DC2-1 =; DC2 

0 ;DC3 

te) 3DC4 
#>X.NAK-1 =; NAK 
#>SCROLLDN-1 ;SYN 
#>SCROLLUP-1 ;ETB 
#>MOUSEOFF-1 
#>X.EM-1 3EM 
#>X.SUB-1 ;SUB 
#>MOUSEON-1 
#>X.FS-1 3FS 
#>X.GS-1 36S 

is) ;RS 
#>X.US-1 3US 


* 
#<X.CUR.ON-$8001 ;ENQ 


CBBA:4B 
CBBB:CB 
CBBC:CB 
CBBD:00 
CBBE:CB 
CBBF:4C 
CBCO:4C 
CBC1 :CB 
CBC2:4B 
CBC3:4B 
CBC4:00 
CBCS :4C 
CBC6 :4C 
CBC7 :00 
CBC8:00 
CBC9:4D 
CBCA:4B 
CBCB:4B 
CBCC:4D 
CBCD:4B 
CBCE:4C 
CBCF:4D 
CBDO:4B 
CBD1:4C 
CBD2:00 
CBD3:4B 
CBD4: 

CBD4: 

CBD4: 

CBD4: 

CBD4: 

CBD4: 

CBD4: 

CBD4: AO 
CBD6: FO 
CBD8: 

CBD8: 

CBD8: 

CBD8: 

CBD8:E6 
CBDA:A5 
CBDC :8D 
CBDF:C5 
CBE: BO 
CBE3:4C 
CBE6: 

CBE6: 

CBE6:CE 
CBE9:C6 
CBEB: 

CBEB:A0 
CBED:8A 
CBEE:48 
CBEF:8C 


00 
15 


FB 
25 


01 


7B 


0s 


cE 


os 


07 


CBED 


CBD8 


CBE6 


CBE6 


DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 0 
DFB O 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB O 
DFB 
INCLUDE SUBS2 


#<X.BS-1 
0 


#<X.LF-1 


#<X.CR-1 


* 


#<X.DC1-$8001 
#<X.DC2-$8001 


#<X.NAK-$8001 
#<SCROLLDN-$8001 ;SYN 
#<SCROLLUP-$8001 
#<MOUSEOFF-$8001 
#<X.EM-$8001 ;EM 
#<X.SUB-$8001 ;SUB 
#<MOUSEON-$8001 
#<X.PS-$8001 FS 
#<X.GS-$8001 ;GS 


#<X.«CUR.OFF-$8001 ;ACK 
#<X.BELL-1} 


;BEL 
3BS 

3HT 
3LF 


#<X.VT-$8001 ;VT 
#<X.FE-$8001 ;FF 


5;CR 


#<X.80-$8001 ;S0 
#<X.SI-$8001 ;SI 
0 


;DLE 
;DC1 
3DC2 
3DC3 
;DC4 
3 NAK 


ETB 


3RS 


#<X.US-$8001 ;US 


* SCROLLIT scrolls the screen either up or down, depending 


* on the value of X. 


* or odd edges for both 40 and 80 columns. 


It scrolls within windows with even 
It can scroll 


* windows down to 1 characters wide. 


* 


SCROLLDN LDY #0 
BEQ SCROLLIT 
* 


* EXECUTE LINEFEED: 
* 


X.LF EQU * 
INC CV 
LDA CV 
STA OURCV 
CMP WNDBTM 
BCS X.LF2 
JMP VTABZ 
X.LF2 EQU * 
DEC OURCV 
DEC CV 
* 
SCROLLUP LbY #1 
SCROLLIT TXA 

PHA 


STY TEMPL 


;direction = down 
5=7go0 do scroll 


;SEE IF OFF BOTTOM 
;O0FF THE END? 


3=>yes, scroll screen 
sexit thru VTABZ 


jback up to bottom 
jand fall into scroll 


;direction = up 
;save X 


;save direction 


Lee 


CBF2:A5 
CBF4:48 
CBF5:2C 
CBF8:10 
CBFA:8D 
CBFD:4A 
CBFE:AA 
CBFF:A5 
CCO1l:4A 
CCO2: BB 
€C03:90 
C€C05:2C 
CC08:2A 
CC09:45 
CCOB:4A 
ccoc:70 
CCOE:BO 
CC10:CA 
CC11:86 
CC13:AD 
CC16:08 
CC17:A6 
CC19:98 
CC1A:D0 
CC1C:A6 
CCIE:CA 
CC1F: 

CC1F:8A 
€C20:20 
C023: 

CC23:A5 
CC25:85 
CC27:A5 
CC29:85 
CC2B: 

CC2B:AD 
CC2E: FO 
CC30:E8 
CC31:E4 
CC33:B0 
CC35:8A 
CC36:20 
CC39:A4 
CC3B:28 
CC3C:08 
cc3D:10 
CC3F:AD 
CC42:98 
CC43:FO 
cc45:Bl 
CC47:91 
CC49:88 
CC4A:D0 
cc4c:70 


ZI 
1F 


1c 
01 


20 


03 


21 


03 
ol 


21 
IF 


22 


03 
23 


03 
28 
2A 
29 
2B 


7B 
32 


23 
32 


03 
21 
1E 
55 
07 
2A 


Fo 
04 


co 
CC16 


cco8 
cB 


cell 
cc 


co 


cclF 


CE 


07 


CC62 


CC67 


CE 


ecsD 
co 


cc4c 


cc45 
ccs2 


LDA 
PHA 
BIT 
BPL 
STA 
LSR 
TAX 
LDA 
LSR 
CLV 


BIT 
ROL 
EOR 
LSR 
BYS 
BCS 
DEX 
STX 
LDA 
PHP 
LDX 
TYA 
BNE 
LDX 
DEX 


CHKRT 


GETST 


GETSTL 


* 
SETDBAS TXA 
JSR 
* 
SCRLIN LDA 
STA 
LDA 
STA 


LDA 
BEQ 
INX 
CPX 
BCS 
TXA 
JSR 
LDY 
PLP 
PHP 
BPL 
LDA 
TYA 
BEQ 
SCRLEVEN LDA 
STA 
DEY 
BNE 
SCRLFT BVS 


SETSRC 


WNDWDTH 


RD8OVID 
GETSTL 
SET80COL 
A 


WNOLFT 
A 


CHKRT 
SEV1 

A 
WNDWDTH 
A 
GETST 
GETST 


WNDWDTH 
RD80VID 


WNDTOP 


SETDBAS 
WNDBIM 


VIABZ 


BASL 
BAS2L 
BASH 
BAS2H 


TEMP1 
SCRLDN 


WNDBTM 
SCRLL3 


VTABZ 
WNDWDTH 


SKPRT 
TXTPAGE2 


SCRLFT 
(BASL),Y 
(BAS2L) ,Y 


SCRLEVEN 
SKPLFT 


;get width of screen window 
;Save original width 

sin 40 or 80 columns? 

3=>40, determine starting line 
jmake sure this is enabled 
sdivide by 2 for 80 column index 
sand save 

;test oddity of right edge 

yby rotating low bit into carry 
3;V=0 if left edge even 

y=>check right edge —~ 

3;V#l if left edge odd 

srestore WNDLFT 

3get oddity of right edge 

;C=#l if right edge even 

31f odd left, don't DEY 

sif even right, don't DEY 

;1€ right edge odd, need one less 
;save window width 

3;N=l if 80 columns 

;save N,Z,V 

sassume scroll from top 

jup or down? 

3=>up 

;down, start scrolling at bottom 
;really need one less 


;get current line 
scalculate base with window width 


;current line is destination 


;test direction 

3=>do the downer 

3;do next line 

jdone yet? 

;=>yup, all done 

3;set new line 

;get base for new current line 
sget width for scroll 

3get status for scroll 

;N=l if 80 columns 

3=>only do 40 columns 

sscroll aux page first (even bytes) 
jtest Y 

3if Y=0, only scroll one byte 


3;do all but last even byte 
sodd left edge, skip this byte 


CC4E:B1 
cc50:91 
CC52:AD 
CC55:A4 
CC57:BO 
cc59:B1 
CC5B:91 
CC5D:88 
CC5E:10 
cc60:30 
CC62: 

CC62:CA 
CC63:E4 
cc65:10 
CC67: 

CC67 :28 
CC68:68 
CC69:85 
CC6B:20 
CC6E:20 
CC71:68 
CC72:AA 
C€C73:60 
cc74: 

cc74: 

cc74: 

€C74:20 
CC77:A5 
CC79:48 
CC7A:10 
cc7C:20 
CC7F:20 
CC82:E6 
CC84:A5 
CC86:C5 
CC88:90 
CC8A:68 
CC8B:85 
cC8D:4C 
cc90: 

cc90: 

cc90: 

cc90: 

C€C90:20 
cC93:4c 
cC96: 

cC96: 

cc96: 

CC96:A0 
CC98: FO 
CC9A: 

CC9A: 

CC9A: 

CC9A:AC 


28 
2A 
54 
04 
28 
2A 
F9 
cl 


22 
CE 


21 


FE 


SF 
74 


00 


7B 


co 


ccsp 


cc59 
cc23 


cc35 


cc 
cD 


cc 


CC82 
cE 
cc 


cc7c 


cD 


cc90 
cB 
cc 


cc9D 


05 


135 


SKPLFT 


SCRLODD 


SKPRT 


SCRLDN 


SCRLL3 


* 


LDA 
STA 
LDA 
LDY 


LDA 
STA 
DEY 
BPL 
BMI 


DEX 
CPX 
BPL 


PLP 
PLA 
STA 
JSR 
JSR 
PLA 
TAX 
RTS 


(BASL),Y 
(BAS2L),Y 
TXTPAGE] 
WNDWDTH 
SKPRT 
(BASL),Y 
(BAS2L),¥ 


SCRLODD 
SCRLIN 


WNDTOP 
SETSRC 


WNDWDTH 
X.SUB 
VTAB 


* EXECUTE CLR TO EOS: 


* 
X.VT 


X.VTLOOP JSR 


X.VTNEXT INC 


* 


JSR 
LDA 
PHA 
BPL 


JSR 


LDA 
CMP 
BCC 
PLA 
STA 
JMP 


X.GS 
cv 


X.VTNEXT 
VTABZ 
X.SUB 

cv 

cv 
WNDBTM 
X.VTLOOP 


cv 
VTAB 


* EXECUTE CLEAR: 


* 
X.FF 


* 


EQU 
JSR 
JMP 


* 


X.EM 
X.VT 


* EXECUTE CLEAR LINE 


* 
X.SUB 


* 


* EXECUTE CLEAR TO EOL: 
* 


X.GS 


LDY 
BEO 


LDY 


#0 
X.GSEOLZ 


OURCH 


jnow do main page (odd bytes) 
;restore width 
j;even right edge, skip this byte 


3™> always scroll next line 


3do next Line 
;done yet 
;=>nope, not yet 


jpull status off stack 
3;testore window width 


3;clear current line 
3restore original cursor line 
jand X 


done!!! 


;CLEAR TO EOL 
;SAVE CV 


3;DO NEXT LINE (ALWAYS TAKEN) 
;set base address 
3;CLEAR LINE 


;OFF SCREEN? 

3=>NO, KEEP GOING 

; RESTORE 

3 CV 

;return via VTAB (blech) 


;HOME THE CURSOR 
;RETURN VIA CLREOS (UGH!) 


sstart at left 
jand clear to end of line 


3get CH 


8ce 


Cc9D:A5 
CC9F:29 
CCA1:09 
CCA3:2C 
CCA6 : 30 


“CCAB:91 


CCAA:C8 
CCAB:C4 
CCAD:90 
CCAF:60 
ccBo: 

CCBO: 

CCBO: 

ccBO: 

CCBO:86 
CCB2:A2 
CCB4:A0 
CCB6:A5 
CCB8:29 
CCBA:4C 
CCBD: 

CCBD: 

CCBD: 

CCBD:86 
CCBF:48 
ccc :98 
CCC1 248 
CCC2:38 
CCC3:E5 
CCC5:AA 
CCC6:98 
CCC7:4A 
CCC8:A8 
CCCI :68 
CCCA:45 
CCCC:6A4 
CCCD: BO 
CCCF:10 
ccD1:c8 
CCD2:68 


. CCD3: BO 


CCD5:2C 
CCD8:91 
CCDA:2C 
CCDD:E8 
CCDE: FO 
CCEO:91 
CCE2:¢8 
CCE3:E8 
CCE4:DO 
CCE6: A6 
CCE8:38 
CCE9:60 
CCEA: 


2A 


14 
32 
AO 
DS 


2A 


21 


20 


03 
o1 


OB 
55 
28 
54 


06 
28 


EF 
2A 


co 


cc 


co 


co 


CCBD 


CCA8 


ccD2 
ccn2 


CCEO 


CCE6 


ccDs 


136 
137 
138 
139 
140 
141 
142 
143 
144 
145 
146 
147 
148 
149 
150 
151 
152 
153 
154 
155 
156 
157 
158 
159 
160 
161 
162 
163 
164 
165 
166 
167 
168 
169 
170 
171 
172 
173 
174 
175 
176 
177 
178 
179 
180 
181 
182 
183 
184 
185 
186 
187 
188 
189 


X.GSEOLZ LDA INVFLG jmask blank 
AND #$80 swith high bit of invflg 
ORA #$20 jmake it a blank 
BIT RD80VID jis it 80 columns? 
BMI CLR80 3=>yes do quick clear 
CLR40 =STA_ (BASL),Y 
INY 
CPY WNDWDTH 
BCC CLR40 
RTS 
* 
* Clear right half of screen for 40 to 80 
* screen conversion 
* 
CLRHALF STX BAS2L ;save X 
LDX #$D8 ;set horizontal counter 
Loy #20 
LDA INVFLG 3set (inverse) blank 
AND #S$A0 
JMP CLR2 
* 
* Clear to end of line for 80 columns 
* 
CLR80 -.STX BAS2L ssave X 
PHA j;and blank 
TYA ;get count for CH 
PHA ;save for left. edge check 
SEC j;count=WNDWDTH-Y-1 
SBC WNDWDTH 
TAX ;save CH counter 
TYA ;div CH by 2 for half pages 
LSR A 
TAY 
PLA jrestore original ch 
EOR WNDLFT sget starting page 
ROR A 
BCS CLRO 
BPL CLRO 
INY 3iff WNDLFT odd, starting byte odd 
CLRO PLA sget blank 
BCS CLRI1 jstarting page is 1 (default) 
CLR2 BIT TXTPAGE2 j;else do page 2 
STA (BASL),Y 
BIT TXTPAGE] jnow do page 1 
INX 
BEQ CLR3 3all done 
CLRI STA (BASL),Y 
INY 3;forward 2 columns 
INX 3;mext ch 
BNE CLR2 snot done yet 
CLR3 LDX BAS2L ;restore X 
SEC ;good exit condition 
RTS jand return 
* 


CCEA: 


CCEA: 


CCEA: 

CCEA: AD 
CCED:30 

CcD3C 

CCEF:20 
CCF2:2C 
CCF5:10 
CCF7:20 
CCFA:90 
CCFC: 

CCFC: 

CCFC: 

CCFC: 

CCFC:20 
CCFF: DO 
CD01:2C 
CD04 :30 
CD06:20 
cD09: 

CD09: AD 
cpoc :18 
CcDOD:65 
CDOF:2C 
€bd12:30 
CD14:c9 
CD16:90 
CD18:A9 
CD1A:8D 
CDID:85 
CDIF:A5 
cp21:20 
CD24 :2C 
CN27:10 
cp29: 

CD29:20 
CD2C: FO 
CD2E: 

CD2£:20 
CD31: A9 
CD33:2C 
CD36 :30 
CD38: A9 
CD3A:85 
CD3C 260 
CD3D: 

CD3D: 

CD3D: 

CD3D: AD 
CD40:09 
Cd42:D0 
CD44: 

CD44: 


FB 
4D 


CCEA 
04 


194 


31 
1F 
12 
91 
oD 


90 
3B 
1F 
03 
C4 


7B 


6D 
00 
1A 
02 
14 
22 


FB 


0s 


cD 
co 


cD 
cp09 


CCFC 

CA 
cD3c 

co 

cp 

05 

co 
CDIA 
CDLA 


05 


CA 


CD2E 


CD31 


cD 


CD3A 


04 


cD49 


190 * EXECUTE '40COL MODE’: 

19) -* 

192 X.DC1 EQU * 

193 LDA MODE jdon"t convert if Pascal 
BMI X.DCLRTS ;=>it's Pascal 

195 X.DCLA JSR SETTOP jset top of window (0 or 20) 
196 BIT RD80VID ;are we in 80 columns? 
197 BPL X.DC1B ;™>no, no convert needed 
198 JSR SCRN84 jelse convert 80 to 40 
199 BCC X.DCLB ;™>always set new window 
200 * 

201 * Set 80 column mode 

202 * 

203 X.DC2 EQU * 

204 JSR TESTCARD ;is there an 80 column card? 
205 BNE X.DCIRTS ;=>no, can't do this 

206 BIT RD80VID sare we in 40 columns? 

207 BMI X.DCIB 3=>no, no convert needed 
208 JSR SCRN48 selse convert 40 to 80 

209 * 

210 X.DC1B LDA OURCH ;get cursor 

211 CLC ;since new window left = 0 
212 ADC WNDLFT ; NEWCH=OLDCH+OLDWNDLFT 
213 BIT RDS8OVID jin 80 columns? 

214 BMI X.DCIC 3;™>yes, CK is ok 

215 CMP #40 jelse if CH is too big, 
216 BCC X.DCIC yset it to 39 

217 LDA #39 

218 X.DC1IC STA OURCH ;save new CH 

219 STA CH 

220 LDA CV ;base 

221 JSR BASCALC 

222 BIT RD80VID 3in 80 columns? 

223 BPL D040 3=>no, set forty column window 
224 * 

225 DO80 JSR FULL80 ;set 80 column window 

226 BEQ SETTOP ;=>always branch 

227 * 

228 DO40 JSR FULL4O ;set 40 column window 

229 SETTOP LDA #0 jassume normal window 
230 BIT RDTEXT jtext or mixed? 

231 BMI DO40A ;=>text, all ok 

232 LDA #20 

233 DO4OA «STA WNDTOP j;set new top 

234 X.DCIRTS RTS 

235 * 

236 * EXECUTE MOUSE TEXT OFF 

237 * 

238 MOUSEOFF LDA MODE 

239 ORA #M.MOUSE ;set mouse bit 

240 BNE SMOUSE 3;to disable mouse chars 
241 * 

242 * EXECUTE MOUSE TEXT ON 


62€ 


CD44: 
CD44: AD 
CD47:29 
CD49:8D 
CD4C:60 
CD4D: 
CD4D: 
CD4D: 
CD4D: 
CD4D: AD 
CD50:30 
CD52:20 
CD55:20 
CD58:20 
CD5B: 
CD5B:A9 
CD5D:85 
CD5F:A9 
CD61:85 
CD63:60 
CD64: 
CD64:A9 
CD66:85 
CD68:A9 
CD6A:85 
CD6C:60 
CD6D: 
CD6D: 
CD6D: 
cD6D: 
CD6D: 
CD6D: 
CD6D: 
CD6D: 
CD6D: 
CcD6D: 
CD6D: A9 
CD6F:DO 
CD71: 
CD71: 
CD71: 
CD71: 
CD71: 
CD71: 
CD71: 
CD71: 
CD71: 
CD71:A9 
€D73:85 
CD75:A9 
CD77:85 
CD79:A9 
CD7B:85 
CD7D:85 


FB 
1A 
2E 
80 
64 


FD 
39 
1B 
38 


FD 
37 


36 


28 
02 


50 
21 


04 


04 


04 


cD 
cD 
cD 


CcD4D 


cD6C 


cDéD 


cb73 


243 
244 
245 
246 
247 
248 
249 
250 
251 
252 
253 
254 
255 
256 
257 
258 
259 
260 
261 
262 
263 
264 
265 
266 
267 
268 
269 
270 
271 
272 
273 
274 
275 
276 
277 
278 
279 
280 
281 
282 
283 
284 
285 
286 
287 
288 
289 
290 
291 
292 
293 
294 
295 
296 


* 
MOUSEON LDA MODE 
AND #255-M.MOUSE ;clear mouse bit 
SMOUSE STA MODE 3to enable mouse chars 
RTS 
* 


* EXECUTE ‘QUIT’: 
* 


X.NAK EQU * 


LDA MODE ;ONLY VALID IN BASIC 
BMI SKRTS jignore if pascal 

JSR DO40 ;force 40 column window 
JSR QUIT j;do stuff used by PR#O 


JSR SETCOUT1 j;set output hook 


* 

SETKEYIN LDA #<KEYIN 
STA KSWH 
LDA #>KEYIN 
STA KSWL 
RTS 


;set input hook 


* 


SETCOUT1 LDA #<COUTI 
STA CSWH 
LDA #>COUTI 
STA CSWL 


SKRTS RTS 
* 


HIKARI III IR III IIR IIS III III OI SAI ISII AA 
* NAME : FULL4O 

* FUNCTION: SET FULL 40COL WINDOW 

* INPUT : NONE 

* OUTPUT : WINDOW PARAMETERS, A=0 


* VOLATILE: AC 
IIR III IKI IIR III III IIIA IARI ARIA AIA IR. 


* 
FULL40 EQU * 
LDA #40 
BNE SAVWDTH 


;set output hook 


3set window width to 40 
3™=>(always taken) 

IIR IIR IR III IR ISI IRI IIR IA III IOI IIIA 

* NAME : FULL80 

* FUNCTION: SET FULL 80COL WINDOW 

* INPUT : NONE 

* OUTPUT : WINDOW PARAMETERS, A=0 


* VOLATILE: AC 
RIKER III RIP IA BIRR IRIS IIR IAI IIIA IIA. 


* 
FULL80 LDA #80 
SAVWDTH STA WNDWDTH 
LDA #24 
STA WNDBTM 
LDA #0 
STA WNDTOP 
STA WNDLFT 


3set full 80 column window 


CD7F:60 
CD80: 

CD80: 

CD80: 

CD80: 

CD80:2C 
CD83:10 
CD85:20 
CD88 :8D 
CD8B:A9 
CD8N:8D 
CD90 :60 
CD9L: 

CD91: 

CD91: 

CD91: 

CD91: 

CD91:8A 
CD92 :48 
CD93:A2 
CD95:8D 
CD98:8A 
CD99:20 
CD9IC: AD 
CD9E:84 
CDAO:98 
CDAL:4A 
CDA2: BO 
CDA4:2C 
CDA7 : A8 
CDA8: Bl 
CDAA:2C 
CDAD: A4 
CDAF:91 
CDB1:88 
CDB2:10 
CDB4:CA 
CDB5:30 
CDB7:E4 
CDB9: BO 
CDBB: 8D 
CDBE:8D 
CDC1:4¢ 
cpc4: 

CDC4:8A 
CDC5:48 
CDC6:A2 
CDC8:8A 
CDCI :20 
CDCC: AO 
CDCE :8D 
CDD1:B1 
CDD3:84 
CDD5 :48 


1F 


EF 
OE 
FF 
FB 


17 
ol 


BA 


27 
2A 


03 


28 
54 
2A 
28 
EA 


04 
22 


00 


F8 


cDB0 
co 
CD88 
cc 
co 


04 


co 


CA 


CDA7 


co 


CD9E 

CDBB 

CD98 
co 


co 
cD 


CA 


co 


297 
298 
299 
300 
301 
302 
303 
304 
305 
306 
307 
308 
309 
310 
311 
312 
313 
314 
315 
316 
317 
318 
319 
320 
321 
322 
323 
324 
325 
326 
327 
328 
329 
330 
331 
332 
333 
334 
335 
336 
337 
338 
339 
340 
341 
342 
343 
344 
345 
346 
347 
348 
349 
350 


RTS 
* 


* QUIT is used by PR#0 to turn off everything 


* 


Quit EQU 
BIT 
BPL 
JSR 
QUIT2 STA 
LDA 
STA 


RTS 
* 


* 
RD8OVID swere we in 80 columns? 
QUIT2 3=> not a chance 
X.DCLA 3;switch to 40 columns 
CLRALTCHAR ;don't use lower case 
#SFF ;DESTROY THE 

MODE ; MODE BYTE 


* SCRN84 and SCRN48 convert screens between 40 & 80 cols. 
* WNDTOP must be set up to indicate the last line to 


* be done. 
* 
SCRN84 TXA 
PHA 
LDX 
STA 
SCRL TXA 
JSR 
LDY 
SCR2 STY 
TYA 
LSR 
BCS 
BIT 
SCR3 TAY 
LDA 
BIT 
LDY 
STA 
DEY 
BPL 
DEX 
BMI 
CPX 
BCS 
SCR4 STA 
STA 
JMP 


SCRN48 TXA 
PHA 
LDX 
SCR5 TXA 
JSR 
LDY 
STA 
SCR6 LDA 
SCR8& STY 
PHA 


All registers are trashed. 


jsave X 
#23 sstart at bottom of screen 
SET80COL j;allow page 2 access 
;eale base for line 
BASCALC 
#39 jstart at right of screen 
BAS2L ;save 40 index 
3div by 2 for 80 column index 
A 
SCR3 
TXTPAGE2 ;even column, do page 2 
jget 80 index 
(BASL),Y ;get 80 char 
TXTPAGE] j;restore pagel 
BAS2L sget 40 index 
(BASL),Y 
SCR2 3do next 40 byte 
;do next line 
SCR4 ;=>done with setup 
WNDTOP sat top yet? 
SCRI 
CLR80COL j;clear 80STORE for 40 columns 
CLR8O0VID j;clear 80VID for 40 columns 
SCRNRET 3calc base, restore X, exit 
;save X 
#23 ;start at bottom of screen 
3set base for current line 
BASCALC 
#0 sstart at left of screen 
SET80COL j;enable page2 store 
(BASL),Y j;get 40 column char 
BAS2L ;save 40 column index 


;save char 


oee 


CE24:DO 
CE26:48 
CE27:98 
CE28:48 
CE29:AC 
CE2C:20 
CE2F:49 
CE31:20 
CE34:68 
CE35: A8 
CE36:68 
CE37:60 
CE38: 
CE38: 
CE38: 
CE38: 
CE38: 
CE38: 
CE38: 
CE38: 
CE38: 
CE38: 
CE38: 
CE38:48 
CE39:24 
CE3B:30 
CE3D:29 
CE3F: 
CE3F:20 
CE42:68 
CE43:60 
CE44: 
CE44: 
CE44: 
CE44: 
CE44: 
CE44: 
CE44: 
CE44: 
CE44: 
CE44:B1 
CE46:2C 
CE49:10 
CE4B:8D 
CE4E:84 
CES0:98 
CE51:45 
CE53:6A 
CE54: BO 
CES6:AD 
CE59:C8 
CESA:98 
CESB:4A 
CE5C:A8 


ll CE37 


7B 05 
44 CE 
80 

70 CE 


32 
02 
7F 


70 CE 


28 
1F co 
19 
01 co 
2A 


20 


04 
55 co 


CE38 


CE3F 


CE3F 


CE64 


CESA 


BNE INVX ;=>cursor off, don't invert 
INVERT PHA ;save AC 
TYA ; AND Y 
PHA 
LDY OURCH 3;GET CH 
JSR PICK ;GET CHARACTER 
EOR #$80 ;FLIP INVERSE/ NORMAL 
JSR STORIT ; ONTO SCREEN 
PLA ;RESTORE Y 
TAY 3; AND AC 
PLA 
INVX RTS 
FOR IR IO RII ROI RIT IRI IIIT ITI I III IIIA I IH 
* NAME : STORCHAR 
FUNCTION: STORE A CHAR ON SCREEN 


* 
* INPUT : AC=CHAR 

* + Y=CH POSITION 
* OUTPUT +: CHAR ON SCREEN 
* VOLATILE: NOTHING 

* 


CALLS : SCREENIT 
KRERERERERIR RRR IRR REI IIR ISI IOS RRA 


* 
STORCHAR EQU * 


PHA ;SAVE AC 
BIT INVFLG ;NORMAL OR INVERSE? 
BMI STOR2 3=>NORMAL 
AND #S$7F jinverse it 
STOR2 EQuU * 
JSR STORIT 3=>do it!! 
PLA ;RESTORE AC 
SEV RTS 
eTTrrrittt ttt ttittirt titi t irri tii r rt 
* NAME =: PICK 
FUNCTION: GET A CHAR FROM SCREEN 


* 
* INPUT : Y=CH POSITION 
* OUTPUT : AC=CHARACTER 
* VOLATILE: NOTHING 

* 


CALLS : SCREENIT 
IRR HRRIER IKI IRR ER RIK IIHR IIA IISSII ISR IAI 


* 

PICK LDA (BASL),Y j;get 40 column character 
BIT RD80VID 380 columns? 
BPL PICK3 3=>no, do text shift 
STA SET80COL ;force 80STORE for 80 columns 
STY BAS2L 3;temp store for position 
TYA ;divide CH by two 
EOR WNDLFT 3C=1 if char in main RAM 
ROR A ;get low bit into carry 
BCS PICKl ;=>store in main memory 
LDA TXTPAGE2 j;else switch in page 2 
INY ;for odd left, aux bytes 

PICK1 TYA jdivide position by 2 
LSR A sand use carry as 
TAY s;page indicator 


CDD6 : 98 
CDD7:4A 
CDD8 : BO 
CDDA: 8D 
CDDD: A8& 
CDDE :68 
CDDF:91 
CDE1:8D 
CDE4 :A4 
CDE6 :C8 
CDE7 :CcO 
CDE9:90 
CDEB:20 
CDEE:CA 
CDEF:30 
CDF1:E4 
CDF3:BO 
CDF5:8D 
CDF8:20 
CDFB:68 
CDFC:AA 
CDFD:60 
CDFE: 

CDFE:A5 
CEOO :8D 
CE03:20 
CEO6:A5 
CEO8 :2C 
CEOB:10 
CEOD:4A 
CEOE:18 
CEOF:65 
CE11:85 
CE13:60 
CEL4: 

CE14:C9 
CE16:90 
CE18:c9 
CE1A: BO 
CE1C:29 
CE1E:60 
CEIF: 

CELF: 

CELF: 

CELF: 

CELF: 

CELF: 

CELF: 

CEIF: 

CEIF: 

CELF: 

CELF: 


03 


28 
54 
2A 


28 
BO 


04 
22 
D3 


FE 


25 
FB 
BA 
20 
1F 
ol 


28 
28 


El 
06 
FB 
02 
DF 


CDDD 
co 


co 


CcDD1 
cc 


CDFS 


cDc8 
co 


05 
CA 


CEOE 


CELE 


CEIE 


CELF:AD FB 04 


CE22:29 


10 


351 
352 
353 
354 
355 
356 
357 
358 
359 
360 
361 
362 
363 
364 
365 
366 
367 
368 
369 
370 
371 
372 
373 
374 
375 


TYA 3;div 2 for 80 column index 
LSR A 
BCS SCR7 ;save on pagel 
STA TXTPAGE2 
SCR7 TAY sget 80 column index 
PLA jnow save character 
STA (BASL),Y 
STA TXTPAGEL ;flip pagel 
LDY BAS2L j;restore 40 column index 
INY j;move to the right 
cPY #40 jat right yet? 
BCC SCR6 3=>no, do next column 
JSR CLRHALF 3clear half of screen 
DEX 3jelse do next line of screen 
BMI SCR9 3;=>done with top line 
CPX WNDTOP jat top yet? 
BCS SCR5 
SCR9 STA SET80VID j;convert to 80 columns 
SCRNRET JSR VTAB jupdate base 
PLA ;Testore X 
TAX 
RTS 


VTAB LDA CV ;get 80 column CV 


STA OURCV ;copy to OURCV 
VTABZ JSR BASCALC scale base address 
LDA WNDLFT sand add window left to it 
BIT RD80VID jis it 80 columns? 
BPL VTAB40 ;window width ok 
LSR A 3else divide width by 2 
VTAB40 CLC ;prepare to add 
ADC BASL 3add in window left 
STA BASL 3and update base 
VTABX RTS jand exit 
INCLUDE SUBS3 
UPSHFT CMP #SEl jis it lowercase? 
BCC UPSHFT2 3=>nope 
CMP #SFB jlowercase? 
BCS UPSHFT2 3=>nope 
AND #SDF jelse upshift 
UPSHFT2 RTS 
* 
FRI IIR IIR III IR IIR IIR IATA IAT IR IIR III III II. 
* NAME : INVERT 
* FUNCTION: INVERT CHAR AT CH/CV 
* : Unless Pascal and M.CURSOR=1 
* INPUT : NOTHING 
* OUTPUT : CHAR AT CH/CV INVERTED 
* VOLATILE: NOTHING 
* CALLS : PICK, STORCHAR 
FIO IRI IAAT ITO FI II OI IIIA IIIA IOS I OIA 


* 


PASINV LDA MODE 3check pascal cursor flag 
AND #M.CURSOR ;before displaying cursor 


Lee 


CE5D:B1 
CE5F:2C 
CE62:A4 
CE64:2C 
CE67:10 
CE69:C9 
CE6B: BO 
CE6D:09 
CE6F:60 
CE70: 

CE70: 

CE70: 

CE70: 

CE70: 

CE70: 

CE70: 

CE70: 

CE70: 

CE70: 

CE70: 

CE70: 

CE70:48 
CE71:29 
CE73:30 
CE75:AD 
CE78:6A 
CE79:68 
CE7A:48 
CE7B:90 
CE7D:2C 
CE80:10 
CE82:49 
CE84:2C 
CE87 :FO 
CE89:49 
CE8B: 

CE8B:2C 
CE8E:10 
CE90:8D 
CE93:48 
CE94 384 
CE96:98 
CE97 345 
CE99:4A 
CE9A:BO 
CE9C:AD 
CE9F:C8 
CEAO:98 
CEAL:4A 
CEA2:A8 
CEA3:68 
CEA4 :91 
CEA6: AD 
CEA9: A4 


28 
54 
2A 
1E 
06 


02 
40 


FF 
16 
FB 


OE 
1E 
09 
40 
AC 
02 
40 


1F 


1D 


2A 


20 


04 


28 
54 
2A 


co 


co 


04 


co 


CE 


co 


co 


co 


co 


CE6F 


CE6F 


CE8B 


CE8B 


CE8B 


CE8B 


CEAD 


CEAO 


109 
110 
lll 
112 
113 
114 
115 
116 
117 
118 
119 
120 
121 
122 
123 
124 
125 
126 
127 


PICK2 LDA (BASL),Y j;get that char 
BIT TXTPAGEL ;flip to page 1 
LDY BAS2L 
PICK3 BIT ALTCHARSET ;only allow mouse text 
BPL PICK4 3if alternate character set 
CMP #$20 
BCS PICK4 
ORA #$40 
PICK4 RTS 
* 
FRI ITI IIIS IIR IAI II IIIS IIIA 
* NAME : STORIT 
* FUNCTION: STORE CHAR 
* INPUT : AC=char for store 
* : Z=high bit of char 
* : Y=CH POSITION 
* OUTPUT : AC=CHAR (PICK) 
* VOLATILE: NOTHING 
* CALLS : NOTHING 
FIR I TRIO ION RIT RII IIR III I IAAI A 
* 
STORIT PHA 3save char 
AND #SFF ;if high bit set... 
BMI STORE] 3;=>not mouse text 
LDA MODE 3is mouse text enabled? 
ROR A suse carry as flag 
PLA jand restore char 
PHA ymeed to save it too 
BCC STOREL 
BIT ALTCHARSET ;only do mouse text if 
BPL STOREL jalt char set switched in 
EOR #$40 3do mouse shift 
BIT HEX60 3is it in proper range? 
BEQ STOREL ;=>yes, leave it 
EOR #$40 selse shift it back 
* 
STORE BIT RD80VID 380 columns? 
BPL STOR40 3=>no, 40 columns 
STA SET80COL ;force 80STORE for 80 columns 
PHA j;save shifted character 
STY BAS2L ;temp storage 
TYA ;Zet position 
EOR WNDLFT 3C=1 if char in main RAM 
LSR A 
BCS STORE2 3;=>yes, main RAM 
LDA TXTPAGE2 j;else flip in main RAM 
INY 3do this for odd left bytes 
STORE2 TYA ;get position 
LSR A jand divide it by 2 
TAY 
STORIT2 PLA jrestore acc 
STA (BASL),Y j;save to screen 
LDA TXTPAGEL ;flip to page 1 
LDY BAS2L 


CEAB: 68 
CEAC :60 
CEAD: 
CEAD:91 
CEAF :68 
CEBO :60 
CEBL: 
CEBL: 
CEBL: 
CEBL: 
CEBL: 
CEB1: 
CEBL: 
CEBI: 
CEBL: 
CEBI: 
CEB1:48 
CEB2 :98 
CEB3 :48 
CEB4: AC 
CEB? :20 
CEBA:8D 
CEBD:29 
CEBF :49 
CEC1 :4¢ 
CEC4: 
CEC4: 
CEC4: 
CEC4: 
CEC4: 
CEC4: 
CEC4: 
CEC4: 
CEC4: 
CEC4: 
CEC4 248 
CEC5:98 
CEC6:48 
CEC7: AC 
CECA: AD 
CECD: 
CECD:20 
CEDO :68 
CED1:A8 
CED2 :68 
CED3 :60 
CED4: 
CED4: 
CED4: 
CED4: 
CED4: 
CED4: 
CED4: 
CED4: 


28 


7B 05 
44 CE 
7B 06 
80 
AB 
cD CE 


7B 05 
7B 06 


70 CE 


CEBL 


CEC4 


CECD 


128 
129 
130 
131 
132 
133 
134 
135 
136 
137 
138 
139 
140 
141 
142 
143 
144 
145 
146 
147 
148 
149 
150 
151 
152 
153 
154 
155 
156 
157 
158 
159 
160 
161 
162 
163 
164 
165 
166 
167 
168 
169 
170 
171 
172 
173 
174 
175 
176 
177 
178 
179 
180 
181 


PLA jrestore true Acc 
HEX60 RTS sand exit 
* 
STOR4O STA (BASL),Y j;quick 40 column store 
PLA ;Testore real char 
RTS 


RREKRKKKEREREREREEREKEEREKKEER EKER REREERAE 


NAME : ESCON 

FUNCTION: TURN ON ‘ESCAPE’ CURSOR 
INPUT : NONE 

OUTPUT =: ‘CHAR'=ORIGINAL CHAR 
VOLATELE: NOTHING 

CALLS : PICK, STORCHAR 

FEO IIIA IIIT I IIA I ITT TI IASI IIH 
* 


ESCON EQU * 


ee ee te 


PHA ;SAVE AC 
TYA ; AND Y 

PHA 

LDY OURCH ;GET CH 

JSR PICK ;GET ORIGINAL CHARACTER 
STA CHAR ; AND REMEMBER FOR ESCOFF 
AND #$80 ;SAVE NORMAL/INVERSE BIT 
EOR #$AB ;MAKE IT AN INVERSE '+! 


JMP ESCRET ;RETURN VIA SIMILAR CODE 
HRERERK IERIE REREAKIIR EERE RRRRRERE AER 


* NAME : ESCOFF 

* FUNCTION: TURN OFF 'ESCAPE' CURSOR 
* INPUT : 'CHAR'=ORIGINAL CHAR 

* OUTPUT : NONE 

* VOLATILE: NOTHING 

* CALLS : STORCHAR 


REREREERRERREEREEERERERREERERREEREEEREREK 
* 


ESCOFF EQU * 


PHA ;SAVE AC 
TYA ; AND Y 

PHA 

LDY OURCH 3GET CH 

LDA CHAR ;GET ORIGINAL CHARACTER 


ESCRET EQU * ;USED BY ESCON 
JSR STORIT 3; EXACTLY AS IT WAS 


PLA ;RESTORE Y 
TAY 

PLA ; AND AC 
RTS 


PIII IRI III III IIA II III IR IAI IOI. 
NAME : PSETUP 

FUNCTION: SETUP ZP FOR PASCAL 

INPUT : NONE 
OUTPUT : NONE 
VOLATILE: AC 


CALLS : NOTHING 
IRR IRI IRI KHIR IK IKK IIR ERIE HAIR IR 


2 


zee 


CED4: 

CED4: 

CED4:20 
CED7:A9 
CED9:85 
CEDB: 

CEDB: AD 
CEDE:29 
CEEO:FO 
CEE2 :46 
CEE4: 

CEE4: 

CEE4: 

CEE7 :85 
CEE9: AD 
CEEC:85 
CEEE: AD 
CEF1:85 
CEF3:60 
CEF4: 

CEF4: 

CEF4: 

CEF4: 

CEF4: 

CEF4: 

CEF4: 

CEF4: 

CEF4:2C 
CEF7:10 
CEF9: AQ 
CEFB:CD 
CEFE:FO 
CFOO:A2 
CF02:2C 
CFO5:30 
CFO7 :A2 
CFO9:8D 
CFOC:2C 
CFOF:AD 
CF12:C9 
CF14:FO 
CF16:E8 
CF17:2C 
CF1A:2C 
CF1D:A0 
CFIF:A9 
CF21:85 
CF23 :84 
CF25:BL 
CF27:91 
CF29:C8 
CF2A:DO 
CF2C:E6 
CF2E:DO 
CF30:BD 
CF33:BD 
CF36:60 


7B 
28 


29 
FB 
25 


CED4 
cD 


04 
CEE4 
CEE4 

07 

07 


05 


CF36 


FB 
CF36 


co 
CFO9 


FB 

co 

FB 
CF17 


co 
co 


CF25 


CF25 
co 
co 


182 * 

183 PSETUP EQU * 

184 JSR FULL80 ;SET FULL 80COL WINDOW 
185 1880 LDA #255 

186 STA INVFLG ;ASSUME NORMAL MODE 

187 * 

188 LDA MODE 

189 AND #M.VMODE 

190 BEQ PSETUPRET ;=>IT'S NORMAL 

191 LSR_ INVFLG ;MAKE IT INVERSE 

192 * 

193 PSETUPRET EQU * 

194 LDA OLDBASL ;SET UP BASE ADDRESS 

195 STA BASL 

196 LDA OLDBASH 

197 STA BASH 

198 LDA OURCV sget user's cursor vertical 
199 STA CV jand set it up 

200 RTS 

2.0] 9 RRR II IOI IO OI TOI IIIS. 

202 * 

203 * COPYROM is called when the video firmware is 
204 * initialized. If the language card is switched 
205 * in for reading, it copies the F8 ROM to the 
206 * language card and restores the state of the 
207 * language card. 

208 * 

209 COPYROM BIT RDLCRAM jis the LC switched in? 
210 BPL ROMOK 3=>no, do nothing 

211 LDA #GOODF8 syes, check $F8 RAM 

212 CMP F8VERSION ;does it match? 

213 BEQ ROMOK ;=> assum ROM is there 
214 Lox #3 jindicate bank 2, RAM write enabled 
215 BIT RDLCBNK2 ;is it bank 2? 

216 BMI BANK2 s™>yes, we were right 

217 LDX #$B sno, bank 1, RAM write enabled 
218 BANK2 STA F8VERSION ;write to see if LC is 
219 BIT $c080 jwrite protected (read RAM) 
220 LDA F8VERSION ;did it change? 

221 CMP #GOODF8 

222 BEQ WRTENBL j;=>yes, write enabled 

223 INX ;else indicate write protect 
224 WRTENBL BIT $CO081 ;read ROM, write RAM 

225 BIT $c081 stwice is nice 

226 LDY #$0 ;now copy ROM to RAM 

227 LDA #$F8 

228 STA CSWH shooks set later 

229 STY CSWL 

230 COPYROM2 LDA (CSWL),Y j;get a byte 

231 STA (CSWL),Y j;and move it 

232 INY 

233 BNE COPYROM2 

234 INC CSWH snext page 

235 BNE COPYROM2 ;finish copy 

236 LDA $C080,x ;read RAM 

237 LDA $co80,x 

238 ROMOK RTS 3;done with ROM copy 


0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
0000: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 


9000 


0001 


0000 


F800 
c100 
c300 
c800 


0001 


F800 
2000 


0000 
0001 
0020 
0021 
0022 
0023 
0024 
0025 
0026 
0027 
0028 


TEST EQU O 


LST 0n,A,V 
IRQTEST EQU 1 

MSB ON ;SET THEM HIBITS 

DO TEST 
F80RG EQU $1800 
IOADR EQU $2000 ;For setting PR# hooks 


Cl1ORG = EQU $2100 

C30RG EQU $2300 

C80RG EQU $2800 
ELSE 

F80RG EQU $F800 

C1ORG EQU $C100 

C30RG EQU $C300 


C80RG EQU $800 
FIN 
RRERARARAREREEREREREEEREEREREREER 
* 
* APPLE 11 
* MONITOR IL 
* 
* COPYRIGHT 1978, 1981, 1984 BY 
* APPLE COMPUTER, INC. 
* 
* ALL RIGHTS RESERVED 
* 
* S. WOZNIAK 1977 
* A. BAUM 1977 
* JOHN A NOV 1978 
* R. AURICCHIO SEP 1981 
* E. BEERNINK 1984 
* 
APPLE2F EQU 1 ;COND ASSM/RRAO981 
* 
REKEAEREREEREERRRERERREERRERERRREE 
ORG F80RG 
OBJ $2000 


HRRIR IRI IIR IAA IIR IRI II II III. 
* 

* Zero Page Equates 
* 

Loco EQU $00 
LOc1 Equ $01 
WNDLFT EQU $20 
WNDWDTH EQU $21 
WNDTOP EQU $22 
WNDBTM EQU $23 


;vector for autost from disk 


j;left edge of text window 
jwidth of text window 
stop of text window 
sbottom#l of text window 


CH EQU $24 scursor horizontal position 
cv EQU $25 ;cursor vertical position 
GBASL EQU $26 ;lo-res graphics base addr. 


GBASH EQU $27 


BASL EQU $28 ;text base address 


eee 


F800: 
F800; 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 


F800: 
F800: 
F800: 
F800: 
F800: 


0029 
002A 
002B 
002¢ 
002c 
002d 
002D 
002E 
002E 
002E 
002F 
002F 
0030 
0031 
0032 
0033 
0034 
0035 
0036 
0037 
0038 
0039 
003A 
003B 
003¢ 
003D 
003E 
003F 
0040 
0041 
0042 
0043 
0044 
0044 
0045 
0045 
0046 
0047 
0048 
0049 
O004E 
OO4F 


0095 


0200 


03FO 
O3F2 
O3F4 
O3F5 
03F8 


$29 
$2A 
$28 
$2¢ 
$2c 
$20 
$2D 
$2E 
$2E 
$2E 
$2F 
$2F 
$30 
$31 
$32 
$33 
$34 
$35 
$36 
$37 
$38 
$39 
$34 
$3B 
$3c 
$3D 
$3E 
$3F 
$40 
$41 
$42 
$43 
$44 
$44 
$45 
$45 
$46 
$47 
$48 
$49 
S4E 
S4F 


$95 


$0200 


$03F0 
$03F2 
$03F4 
$03F5 


BASH EQU 
BAS2L EQU 
BAS2H EQU 
H2 EQU 
LMNEM = EQU 
v2 EQU 
RMNEM = EOU 
MASK EQU 
CHKSUM EQU 
FORMAT EQU 
LASTIN EQU 
LENGTH EQU 
COLOR EQU 
MODE EQU 
INVFLG EQU 
PROMPT EQU 
YSAV EOQU 
YSAV1 EQU 
CSWL EQU 
CSWH EQU 
KSWL £QU 
KSWH EQU 
PCL £QU 
PCH EQU 
ALL OU 
AlH EQU 
A2L EQU 
A2H EQU 
A3L EQU 
A3H EQU 
ASL EQU 
AGH EQU 
A5L EQU 
MACSTAT EQU 
ASH EQU 
ACC EQU 
XREG EQU 
YREG EQU 
STATUS EQU 
SPNT EQU 
RNDL EQU 
RNDH EOU 
* 

PICK EQU 
* 

IN EQU 
* 

* Page 3 vectors 
* 

BRKV EQU 
SOFTEV EQU 
PWREDUP EQU 
AMPERV EQU 
USRADR EQU 


$03F8 


;temp base for scrolling 


;temp for lo-res graphics 
j;temp for mnemonic decoding 
;temp for lo-res graphics 
;temp for mnemonic decoding 
;color mask for lo-res gr. 
;temp for opcode decode 
;temp for opcode decode 
;temp for tape read csum 
;temp for opcode decode 
;color for lo-res graphics 
;Monitor mode 
jnormal/inverse(/flash) 
;prompt character 

;position in Monitor command 
;temp for Y register 
;character output hook 


;character input hook 
;temp for program counter 


;Al-A5 are Monitor temps 


s;machine state for break 


;Ace after break (destroys ASH) 
3X reg after break 

3Y reg after break 

3P reg after break 

;SP after break 

;random counter low 

;random counter high 


;CONTROL-U character 


jinput buffer for GETLN 


j;vectors here after break 

;vector for warm start 

;THIS MUST = EOR #$A5 OF SOFTEV+1 
3;APPLESOFT & EXIT VECTOR 
;Applesoft USR function vector 


F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800: 
F800 :4A4 
F801 :08 


O3FB 
O3FE 


0400 
O7F8 


0000 


cooo 


coo0o 
c006 
007 
c010 
cOlF 
c020 
c030 
050 
cosl 
c052 
c053 
C054 
c055 
c056 
cO57 
c058 
cos9 
COSA 
cO5B 
cose 
cosD 
COSE 
cOSF 
c060 
C064 
co70 


C3FA 
c47C 


C567 
c5D1 
CS5SAA 


CFFF 
E000 
E003 


F802:20 47 F8 


F805:28 
F806:A9 OF 


114 
115 
116 
117 
118 
119 
120 
121 
122 
123 
124 
125 
126 
127 
128 
129 
130 
131 
132 
133 
134 
135 
136 
137 
138 
139 
140 
141 
142 
143 
144 
145 


NMI 
TRQLOC 


LINE] 
MSLOT 


IOADR 


* 
KBD 


EQU 
EQU 


EQU 
EQU 


DO 


ELSE 


EQU 
FIN 


EQU 


$O3FB ;NMI vector 

$O3FE ;Maskable interrupt vector 
$0400 3first line of text screen 
$O7F8 jcurrent user of $C8 space 
TEST 

$co00 

$c000 


SLOTCXROM EQU $C006 senable slots 1-7 


INTCXROM EQU $C007 


KBDSTRB 
RDSOVID 
TAPEOUT 
SPKR 
TXTCLR 
TXTSET 
MIXCLR 
MIXSET 
LOWSCR 
HISCR 
LORES 
HIRES 
SETANO 
CLRANO 
SETANI 
CLRAN1 
SETAN2 
CLRAN2 
SETAN3 
CLRAN3 
TAPEIN 
PADDLO 
PTRIG 

* 

IRQ 
TROFIX 
* 


XHEADER 
XREAD 
WRITE2 
* 


CLRROM 
BASIC 
BASIC2 
* 


PLOT 


EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EOU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 


EQU 
EQU 


EQU 
EQU 
EQU 


EQU 
EQU 
EQU 


LSR 
PHP 
JSR 
PLP 
LDA 


;swap out slots for firmware 
$c010 
$cO1F 
$c020 
$c030 
$c050 
$cosl 
$c052 
$c053 
$c054 
$cos5 
$c056 
$c057 
$C058 
$c059 
$CO5A 
$COSB 
$cosc 
$cO5D 
$CO5E 
$COSF 
$C060 
$c064 
$c070 


C3ORG+$FA ;IRQ entry in $C3 page 
C30RG+$17C ;Restore state at IRQ 


C3ORG+$267 
C30RG+$2D1 
C3ORG+$2AA 


SCFFF 
$E000 
$E003 


A 3¥-COORD/2 
;SAVE LSB IN CARRY 
GBASCALC ;CALC BASE ADR IN GBASL,H 
;RESTORE LSB FROM CARRY 
#S$0F sMASK $OF IF EVEN 


bee 


F808 :90 
F80A:69 
F80C:85 
F80E: Bl 
F810:45 
F812:25 
F814:51 
F816:91 
F818:60 
F819: 

F819:20 
F81LC:c4 
F81E: BO 
F820:C8 
F821:20 
F824:90 
F826:69 
F828:48 
¥829:20 
F82C:68 
F82D:C5 
F82F:90 
F831:60 
F832: 

F832:A0 
F834:D0 
F836: A0 
F838:84 
F83A: 

F83A:A0 
F83C:A9 
F83E:85 
F840;:20 
F843:88 
F844:10 
F846:60 
F847: 

F847:48 
F848:44 
F849:29 
F84B:09 
F84D:85 
F84F:68 
F850:29 
F852:90 
F854:69 
F856:85 
F858:0A 
F859:0A 
F85A:05 
F85C:85 
F85E:60 
F85F: 

F85F:A5 


FS 


03 
04 
27 


18 
02 
26 


26 


30 


F8 


F8 


F8 


F8 


F80c 


F831 


F8ic 


F826 


F838 


F83C 


F856 


146 
147 
148 
149 
150 
151 
152 
153 
154 
155 
156 
157 
158 
159 
160 
161 
162 
163 
164 
165 
166 
167 
168 
169 
170 
171 
172 
173 


174 ; 


175 
176 
177 
178 
179 
180 
181 
182 
183 
184 
185 
186 
187 
188 
189 
190 
191 
192 
193 
194 
195 
196 
197 
198 
199 


RTMASK 
PLOTI 


* 


HLINE 
HLINEL 


VLINEZ 
VLINE 


RTS1 
* 


CLRSCR 


CLRIOP 
CLRSC2 


CLRSC3 


* 


GBASCALC PHA 


GBCALC 


* 
NXTCOL 


BCC 


STA 
LDA 
EOR 


EOR 
STA 
RTS 


JSR 
CPY 
BCS 
INY 
JSR 
BCC 
ADC 
PHA 
JSR 
PLA 
CMP 
BCC 
RTS 


LDY 
BNE 
LOY 
STY 


LDY 
LDA 
STA 
JSR 
DEY 
BPL 
RTS 


LSR 
AND 
ORA 
STA 
PLA 
AND 
BCC 
ADC 
STA 
ASL 
ASL 
ORA 
STA 
RTS 


LDA 


RTMASK 
#$E0 
MASK 
(GBASL) ,¥ 
COLOR 
MASK 
(GBASL),Y 
(GBASL),Y 


PLOT 
H2 
RTS1 


PLOT 
HLINE1 
#S$01 


PLOT 


v2 
VLINEZ 


#$2F 
CLRSC2 
#$27 
v2 


#$27 
#$00 
COLOR 
VLINE 


CLRSC3 


A 
#803 
#$04 
GBASH 


#$18 
GBCALC 
#S7F 
GBASL 
A 

A 
GBASL 
GBASL 


COLOR 


;MASK $FO IF ODD 


XOR DATA 


; 
; 

; AND MASK 
; TO DATA 


;PLOT SQUARE 

;DONE? 

YES, RETURN 

NO, INCR INDEX (X-COORD) 
;PLOT NEXT SQUARE 

;ALWAYS TAKEN 

;NEXT Y-COORD 

; SAVE ON STACK 

; PLOT SQUARE 


; DONE? 
; NO, LOOP. 


;MAX Y, FULL SCRN CLR 

;ALWAYS TAKEN 

;MAX Y, TOP SCRN CLR 

;STORE AS BOTTOM COORD 
FOR VLINE CALLS 

;RIGHTMOST X-COORD (COLUMN) 

;TOP COORD FOR VLINE CALLS 

;CLEAR COLOR (BLACK) 

;DRAW VLINE 

;NEXT LEFTMOST X-COORD 

;LOOP UNTIL DONE. 


;FOR INPUT OODEFGH 


;GENERATE GBASH=000001 FG 


3AND GBASL=HDEDEO0O 


; INCREMENT COLOR BY 3 


F861:18 
F862:69 
F864:29 
F866:85 
F868:0A 
F869:0A 
F86A:0A 
F86B:0A 
F86C:05 
F86E:85 
F870:60 
F871: 

F871:4A 
F872:08 
F873:20 
F876:B1 
F878:28 
F879:90 
F87B:4A 
F87C:4A 
F87D:4A 
F87E:4A 
F87F:29 
F881 :60 
F882: 

F882: 46 
F884: A4 
F886:20 
F889:20 
F88C: Al 
F88E:A8 
F88F:4A 
F890 :90 
F892:6A 
F893:B0 
F895:C9 
F897: FO 
F899:29 
F89B:4A 
F89C:AA 
F89D:BD 
F8A0:20 
F8A3: DO 
F8A5:A0 
F8A7:A9 
F8A9:AA 
F8AA:BD 
F8AD:85 
FBAF: 

F8AF: 

F8AF: 

F8AF: 

FBAF: 

F8AF: 


03 
OF 
30 


30 
30 


47 
26 


04 


OF 


3A 
96 
48 
3A 
09 
10 
oc 
87 


62 
79 
04 


00 


A6 
2E 


F8 


F87F 


FD 
F9 


F89B 


F8A5 


F8A5 


F9 


F8A9 


Fo 


200 
201 
202 
203 
204 
205 
206 
207 
208 
209 
210 
211 
212 
213 
214 
215 
216 
217 
218 
219 
220 
221 
222 
223 
224 
225 
226 
227 
228 
229 
230 
231 
232 
233 
234 
235 
236 
237 
238 
239 
240 
241 
242 
243 
244 
245 
246 
247 
248 
249 
250 
251 
252 
253 


CLC 


SETCOL AND #$OF 
STA COLOR 
ASL A ;BOTH HALF BYTES OF COLOR EQUAL 
ASL A 
ASL A 
ASL A 
ORA COLOR 
STA COLOR 
RTS 


;SETS COLOR=17*A MOD 16 


SCRN LSR A ;READ SCREEN Y-COORD/2 
PHP ;SAVE LSB (CARRY) 
JSR GBASCALC ;CALC BASE ADDRESS 
LDA (GBASL),Y ;GET BYTE 


PLP ;RESTORE LSB FROM CARRY 
SCRN2 BCC RTMSKZ ;1F EVEN, USE LO H 
LSR A 
LSR A 
LSR A ;SHLFT HIGH HALF BYTE DOWN 
LSR A 
RIMSKZ AND #SOF ;MASK 4-BITS 
RTS 
* 
INSDS1 LDX PCL sPRINT PCL,H 
LDY PCH 
JSR PRYX2 
JSR PRBLNK ;FOLLOWED BY A BLANK 
LDA (PCL,X) ;GET OPCODE 
INSDS2 TAY 
LSR A ;EVEN/ODD TEST 
BCC [EVEN 
ROR A ;BIT 1 TEST 
BCS ERR 3;XXXXXX11 INVALID OP 
CMP #SA2 
BEQ ERR ;OPCODE $89 INVALID 
AND #$87 ;MASK BITS 
IEVEN LSR A 3LSB INTO CARRY FOR L/R TEST 
TAX 
LDA FMT1,X ;GET FORMAT INDEX BYTE 
JSR SCRN2 3R/L H-BYTE ON CARRY 
BNE GETFMT 
ERR LpY #$80 ;SUBSTITUTE $80 FOR INVALID OPS 
LDA #$00 ;SET PRINT FORMAT INDEX TO 0 
GETFMT TAX 
LDA FMT2,X ; INDEX INTO PRINT FORMAT TABLE 
STA FORMAT ;SAVE FOR ADR FIELD FORMATTING 
; (O=1 BYTE, 1=2 BYTE, 2=3 BYTE) 
* 
* Move code to Cl-C2 because the code 
* that tests for ROM in slot 3 must be in 
* the F8 ROM. 
* 


see 


F8AF:AA 
F8BO 384 
F8B2:A0 
F8B4:4C 
F8B7: 

F8B7: 

F8B7: 

F8B7: 

F8B7: 

F8B7: 

F8B7: 

F837 :8D 
F8BA:A2 
F8BC: BD 
PSBF:DD 
F8C2 :DO 
F8C4:CA 
F8CS:CA 
F8C6:10 
F8C8 :88 
F8C9:DO 
F8CB:8D 
F8CE :60 
F8CF: 

F8CF:EA 
F8D0: 

F8D0:20 
F8D3:48 
F8D4:B1 
F8D6 :20 
F8D9:A2 
F8DB:20 
F8DE:C4 
F8E0 :C8 
F8E1:90 
F8E3:A2 
F8E5:CO 
F8E7:90 
F8E9:68 
F8EA:A8 
F8EB:B9 
F8EE:85 
F8FO:B9 
F8F3:85 
F8F5:A9 
F8F7:A0 
F8F9:06 
F8FB:26 
F8FD:2A 
F8FE:88 
F8FF:DO 
F901:69 
F903:20 
F906:CA 


2A 


82 


3A 
DA 


4A 
2F 


Fl 


04 
F2 


F8 
BF 
ED 


FB 


co 


co 


F8 


FD 


F9 


F9 


FA 


FD 


F8cB 


F8BC 


F8BA 


F8D4 


F8DB 


F8F9 


254 
255 
256 
257 
258 
259 
260 
261 
262 
263 
264 
265 
266 
267 
268 
269 
270 
271 
272 
273 
274 
275 
276 
277 
278 
279 
280 
281 
282 
283 
284 
285 
286 
287 
288 
289 
290 
291 
292 
293 
294 
295 
296 
297 
298 
299 
300 
301 
302 
303 
304 
305 
306 
307 


TAX 
STY 
LDY 


JMP 
* 


BAS2L 
#$10 
GOTOCX 


3;save ACC in X 

jand Y in scrolling temp 
3call = finish mnemonics 
;0ff to C100 


* Test slot 3 for a card containing ROM. 

* If there is one, we'll not switch in our internal 
* slot 3 firmware (for 80 columns). 

* On entry Y has a high value like $F2, so the 

* ROM/bus is read a bunch of times 


TSTROM STA 
TSTROMO LDX 
TSTROM] LDA 
CMP 
BNE 
DEX 
DEX 
BPL 
DEY 
BNE 
XTST STA 
RTS 
* 
NOP 
* 
INSTDSP JSR 
PHA 
LDA 
JSR 
LDX 
PRNIBL JSR 
cPY 
INY 
BCC 
LDX 
cPY 
BCC 
PLA 
TAY 
LDA 
STA 
LDA 
STA 
PRMNL LDA 
LDY 
PRMN2 ASL 
ROL 
ROL 
DEY 
BNE 
ADC 
JSR 
DEX 


PRNTOP 


SLOTCXROM 
#2 
$¢305,X 
CLREOL,X 
XTST 


TSTROM1 


TSTROMO 
INTCXROM 


INSDS1 


(PCL),Y 
PRBYTE 
#$01 
PRBL2 
LENGTH 


PRNTOP 
#$03 
#504 
PRNTBL 


MNEML,Y 
LMNEM 
MNEMR,Y 
RMNEM 
#$00 
#505 
RMNEM 
LMNEM 
A 


PRMN2 
#SBF 
COUT 


3;swap in slots 

;check 2 ID bytes 

3at C305 and $C307 

3;with two bytes that are same 


3check next ID byte 


3if ROM ok, exit with BEQ 
3;swap internal ROM 

j;and return there 

j;line things up 

3;GEN FMT, LEN BYTES 

;SAVE MNEMONIC TABLE INDEX 
;PRINT 2 BLANKS 


;PRINT INST (1-3 BYTES) 
3IN A 12 CHR FIELD 


;CHAR COUNT FOR MNEMONIC INDEX 


;RECOVER MNEMONIC INDEX 


;FETCH 3-CHAR MNEMONIC 
3; (PACKED INTO 2-BYTES) 


;SHIFT 5 BITS OF CHARACTER INTO A 


3; (CLEARS CARRY) 


;ADD "?" OFFSET 
;OUTPUT A CHAR OF MNEM 


F907 : DO 
F909:20 
F90C: AS 
F9OE: A2 
F910:E0 
F912:FO 
F914:06 
F916:90 
F918: BD 
F91B:20 
F9LE:BD 
F921:FO 
F923:20 
F926:CA 
F927:D0 
F929:60 
F92A:88 
F92B:30 
F92D:20 
F930: A5 
F932:C9 
F934:BL 
F936:90 
F938:20 
F9O3B:AA 
F93C:E8 
F93D:DO 
F93F:C8& 
F940:98 
F941:20 
F944:8A 
F945:4C 
F948: 

F948 :A2 
FO4A:A9 
F94C:20 
FO4F:CA 
F950:DO 
F952 :60 
F953: 

F953:38 
F954: A5 
F956:A4 
F958:AA 
F959:10 
F95B:88 
F95C:65 
F95E:90 
F960:C8 
F961:60 
F962: 

F962: 

F962: 

F962: 


EC 
48 
2F 


03 
1c 
2E 
OE 
B3 
ED 
Bo 
ED 
E7 
E7 
DA 
2E 
£8 


3A 
F2 


01 


DA 


DA 


03 


ED 


F8 


2F 
3B 


aL 


3A 
ol 


F8FS 
F9 


F930 
F926 
F9 
FD 
F9 
F926 
FD 


F910 


F914 
FD 


F92A 
F9 


F940 


FD 


FD 


FD 


F94A 


F95C 


F961 


308 
309 
310 
311 
312 
313 
314 
315 
316 
317 
318 
319 
320 
321 
322 
323 
324 
325 
326 
327 
328 
329 
330 
331 
332 
333 
334 
335 
336 
337 
338 
339 
340 
341 
342 
343 
344 
345 
346 
347 
348 
349 
350 
351 
352 
353 
354 
355 
356 
357 
358 
359 
360 


361 ; IF ¥=1 


PRADR1 


PRADR2 


PRADR3 
PRADR4 


PRADRS 


RELADR 


PRNTYX 
PRNTAX 
PRNTX 


PRBLNK 
PRBL2 
PRBL3 


PCADJ 
PCADJ2 
PCADJ3 


PCADJ4 


RTS2 


3; FMT1 BYTES: 


BNE 
JSR 
LDY 
LDX 
CPX 
BEQ 
ASL 
BCC 
LDA 
JSR 
LDA 
BEQ 
JSR 
DEX 
BNE 
RTS 
DEY 
BMI 
JSR 
LDA 
CMP 
LDA 
BCC 
JSR 
TAX 
INX 
BNE 
INY 
TYA 
JSR 
TXA 
JMP 


LDX 
LDA 
JSR 
DEX 
BNE 
RTS 


SEC 
LDA 
LDY 
TAX 
BPL 
DEY 
ADC 
BCC 
INY 
RTS 


3; IF Y=0 


PRMNI 
PRBLNK 
LENGTH 
#506 

#$03 
PRADR5 
FORMAT 
PRADR3 
CHARI-1,X 
couT 
CHAR2-1,X 
PRADR3 
COUT 


PRADR1 
PRADR2 
PRBYTE 
FORMAT 
#SE8 
(PCL) ,Y 


PRADR4 
PCADJ3 


PRNTYX 


PRBYTE 
PRBYTE 
#$03 
#$A0 
couT 


PRBL2 


LENGTH 
PCH 


PCADJ4 


PCL 
RTS2 


;OUTPUT 3 BLANKS 
3;CNT FOR 6 FORMAT BITS 


;IF X=3 THEN ADDR. 


;HANDLE REL ADR MODE 
;SPECIAL (PRINT TARGET, 
3; NOT OFFSET) 


;PCL,PCH+OFFSET+1 TO A,Y 
+1 TO Y,x 


;OUTPUT TARGET ADR 
3 OF BRANCH AND RETURN 


;BLANK COUNT 
;LOAD A SPACE 
;OUTPUT A BLANK 


;LOOP UNTIL COUNT=0 
;0=1 BYTE, 1=2 BYTE, 

3 283 BYTE 

;TEST DISPLACEMENT SIGN 
; (FOR REL BRANCH) 
;EXTEND NEG BY DECR PCH 


;PCL+LENGTH(OR DISPL)+1 TO A 
3 CARRY INTO Y (PCK) 


XXXXXXYO INSTRS 
THEN LEFT HALF BYTE 
THEN RIGHT HALF BYTE 


9ee 


F962: 

F962: 

F962 :04 
F963:20 
F964:54 
F965:30 
F966:0D 
F967 :80 
F968 :04 
F969:90 
F96A :03 
F96B:22 
F96C:54 
F96D:33 
F96E:0D 
F96F:80 
F970:04 
F971:90 
F972:04 
F973:20 
F974:54 
F975:33 
F976:0D 
F977 :80 
F978:04 
F979:90 
F97A:04 
F97B:20 
F97C:54 
F97D:3B 
F97E:0D 
F97F:80 
F980:04 
F981:90 
F982:00 
F983:22 
F984 :44 
F985:33 
F986:0D 
F987 :C8 
F988 :44 
F989 :00 
FOBA:11 
F98B:22 
F98C:44 
F98D:33 
F98E:0D 
F98F:C8 
F990:44 
F991 :A9 
F992:01 
F993:22 
F994 :44 
F995:33 


362 ; 
363 ; 
364 FMT1 
365 
366 
367 
368 
369 
370 
371 
372 
373 
374 
375 
376 
377 
378 
379 
380 
381 
382 
383 
384 
385 
386 
387 
388 
389 
390 
391 
392 
393 
394 
395 
396 
397 
398 
399 
400 
401 
402 
403 
404 
405 
406 
407 
408 
409 
410 
411 
412 
413 
414 
415 


DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DEB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 


$04 
$20 
$54 
$30 
$oD 
$80 
$04 
$90 
$03 
$22 
$54 
$33 
$oD 


$04 
$90 
$04 
$20 
$54 
$33 
$oD 
$80 
$04 
$90 
$04 
$20 
$54 
$3B 
$0D 
$80 
$04 
$90 
$00 
$22 
$44 
$33 
$oD 
$c8 
$44 
$00 
$11 
$22 
$44 
$33 
$0D 
$c8 
$44 
$49 
$01 
$22 
$44 
$33 


(X=INDEX) 


F996:0D 
F997 :80 
F998:04 
F999 :90 
F99A:01 
F99B:22 
F99C 244 
F99D:33 
F99E:0D 
F99F:80 
F9A0:04 
F9A1:90 
F9A2:26 
F9A3:31 
F9A4:87 
F9A5:9A 
F9A6: 

F9A6: 

F9A6: 

F9A6:00 
F9A7:21 
F9A8:81 
F9A9:82 
F9AA:00 
F9AB:00 
F9AC:59 
F9AD:4D 
F9AE:91 
F9OAF:92 
F9BO:86 
FOBL:4A 
F9B2:85 
F9B3:9D 
F9B4:AC 
F9B5:A9 
F9B6: AC 
F9B7:A3 
F9B8:A8 
F9B9:A4 
FOBA:D9 
F9BB:00 
FOBC:D8 
FOBD:A4 
FOBE:A4 
F9BF:00 
F9CO:1C 
F9C1:8A 
F9C2:1C 
F9C3:23 
F9C4:5D 
F9C5:8B 
F9C6:1B 
F9C7:Al 
F9C8:9D 


416 
417 
418 
419 
420 
421 
422 
423 
424 
425 
426 
427 
428 
429 
430 
431 
432 
433 
434 
435 
436 
437 
438 
439 
440 
44) 
442 
443 
444 
445 
446 
447 
448 
449 
450 
451 
452 
453 
454 
455 
456 
457 
458 
459 
460 
461 
462 
463 
464 
465 
466 
467 
468 
469 


CHARI 


CHAR2 


MNEML 


DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 


DFB 
DFB 
DFB 
DF8 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 


$oD 
$80 
$04 
$90 
$01 
$22 
$44 
$33 
$op 
$80 
$04 
$90 
$26 
$31 
$87 
S9A 


ZZXXXYO1 INSTR'S 


$00 
$21 
$81 
$82 
$00 
$00 
$59 
$4D 
$9 
$92 
$86 
$4A 
$85 
$9D 
$AC 
$a9 
$AC 
$a3 
$A8 
$A4 
$D9 
$00 
$D8 
$A4 
SA4 
$00 
$lc 
$8A 
$ic 
$23 
$5D 
$8B 
$1B 
$Al 
$9D 


;ERR 

; IMM 
;Z-PAGE 

; ABS 

; IMPLIED 
3; ACCUMULATOR 
3(ZPAG,xX) 
3(ZPAG),Y 
3ZPAG,X 
;ABS,X 
;ABS,Y 

3 (ABS) 
3;ZPAG,Y 

3 RELATIVE 
wot 

Fed fe 

8 

Ter 

st# 


Par @ 


Lee 


F9C9:8A 
F9CA:1D 
F9CB:23 
F9CC:9D 
F9CD:8B 
POCE:1D 
F9OCF:Al 
F9D0 :00 
F9D1:29 
F9D2:19 
F9D3 : AE 
F9D4 369 
F9D5:A8 
F9D6:19 
F9D7:23 
F9D8:24 
F9D9:53 
FODA:1B 
F9DB:23 
F9ODC:24 
F9DD:53 
F9DE:19 
FODF:Al 
F9EO:00 
FORI:1A 
F9E2 : 5B 
F9E3:5B 
F9E4:A5 
F9E5 #69 
F9E6:24 
F9E7 :24 
F9E3:AE 
F9E9: AE 
F9EA: A8 
POEB:AD 
F9EC:29 
F9ED:00 
F9EE:7C 
F9EF:00 
F9FO:15 
FOFL:9C 
F9F2:6D 
F9OF3:9C 
FOF4: AS 
POF5:69 
F9F6:29 
F9F7 353 
FOF8:84 
F9OF9:13 
FOFA:34 
FOFB:11 
FOFC:A5 
F9OFD:69 
FOFE:23 


470 
471 
472 
473 
474 
475 
476 
477 
478 
479 
480 
481 
482 
483 
484 
485 
486 
487 
488 
489 
490 
491 
492 
493 
494 
495 
496 
497 
498 
499 
500 
501 
502 
503 
504 
505 
506 
507 
508 
509 
510 
S11 
512 
513 
514 
515 
516 
517 
518 
519 
520 
521 
522 
523 


DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
OFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DEB 
DFB 


$8A 
$1D 
$23 
$9D 
$8B 
$1D 
SAl 
$00 
$29 
$19 
SAE 
$69 
$A8 
$19 
$23 
$24 
$53 
$1B 
$23 
$24 
$53 
$19 
SAL 
$00 
SLA 
$5B 
$5B 
SA5 
$69 
$24 
$24 
SAE 
SAE 
$A8 
SAD 
$29 
$00 
$7c 
$00 
$15 
$9c 
$6D 
$9c 
$A5 
$69 
$29 
$53 
$84 
$13 
$34 
$11 
SA5 
$69 
$23 


3 (A) 


> (B) 


3 (Cc) 


3 (D) 


(E) 


FORMAT ABOVE 


FORMAT 


FORMAT 


FORMAT 


FORMAT 


FOFF:A0 
FAOO: D8 
FAO] :62 
FAO2:5A 
FAO3:48 
FAO4:26 
PAOS :62 
FA06:94 
FAO7 :88 
FAO8:54 
FA09:44 
FAOA:C8 
FAOB:54 
FAOC:68 
FAOD:44 
PAOE: E8 
FAOF :94 
FALO:00 
FAL1:B4 
FAL2:08 
PAL3:84 
FAL4:74 
FAL5S : B4& 
FAL6:28 
FAL7:6E 
PAL8:74 
FAL9:F4 
FALA:CC 
FALB:4A 
FALC:72 
FALD:F2 
FALE: A4 
FALF:8A 
FA20:00 
PA21:AA 
FA22:A2 
FA23:A2 
FA24:74 
FA25:74 
FA26:74 
FA27:72 
FA28:44 
FA29:68 
PA2A: B2 

567 
FA2B:32 
FA2C: B2 
FA2D:00 
FA2E:22 
PA2F:00 
FA30:1A 
FA3L:14 
FA32:26 
FA33:26 


524 
525 MNEMR 
526 
527 
528 
529 
530 
531 
532 
533 
534 
535 
536 
537 
538 
539 
540 
541 
542 
543 
544 
545 
546 
547 
548 
549 
550 
551 
552 
553 
554 
555, 
556 
557 
558 
559 
560 
561 
562 
563 
564 
565 
566 


DFB $B2 
568 
569 
570 
571 
572 
573 
574 
575 
576 


DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 


DFB 
DFB 
DFB 
DFB 
DFB 
DEB 
DFB 
DFB 
DFB 


$A0 
$D8 
$62 
$5A 
$48 
$26 
$62 
$94 
$88 
$54 
$44 
$c8 
$54 
$68 
$44 
$E8 
$94 
$00 
$B4 
$08 
$84 
$74 
$B4 
$28 
$6E 
$74 
SF4 
$cc 
$4A 
$72 
$F2 
$A4 
$8A 
$00 
SAA 
$A2 
$A2 
$74 
$74 
$74 
$72 
$44 
$68 


$32 
$B2 
$00 
$22 
$00 
SIA 
S1A 
$26 
$26 


ve 


(A) FORMAT 


(B) FORMAT 


(C) FORMAT 


Bee 


FA34:72 
FA35:72 
FA36:88 
FA37:C8 
FA38:C4 
FA39:CA 
PA3A:26 
FA3B:48 
FA3C:44 
FA3D:44 
FA3E:A2 
PA3F:C8 
FA40: 

FA4O: 

FA4O: 

FA40:85 
FA42:A5 
FAG4:4C 
FA47: 

FA47 :8D 
FA4A:85 
FA&C: 

FA4C:28 
FA4D:20 
FA50:68 
FA5S1:85 
FAS3:68 
FA5S4:85 
FA56:6C 
FAS9: 

FAS9:20 
FASC :20 
FASF:4C 
FA62:D8 
FA63:20 
FA66:20 
PA69:20 
FA6C:20 
FA6F:AD 
FA72:AD 
FA75:A0 
FA77:20 
FA7A:EA 
FA7B:AD 
FA7E:2C 
FA81:D8 
FA82:20 
FA85:AD 
FA88:49 
FA8A:CD 
FA8D:DO 
FA8F:AD 
FA92:DO 
FA94:A9 


45 
45 
FA 
06 
45 
4c 


3A 


C3FA 


c3 


co 


FF 


03 
F8 


FA 
FF 


FAA6 


FAA3 


577 
578 
579 
580 


582 
583 
584 
585 
586 
587 
588 
589 
590 
591 
592 
593 
594 
595 
596 
597 
598 
599 
600 
601 
602 
603 
604 
605 
606 
607 
608 
609 
610 
611 
612 
613 
614 
615 
616 
617 
618 
619 
620 
621 
622 
623 
624 
625 
626 
627 
628 
629 
630 


NEWIRQ 


OLDIRQ 


* 


NEWBREAK STA 


* 
BREAK 


OLD BRK 


RESET 


INITAN 


NEWMON 


DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 


EQU 


STA 
LDA 
JMP 


STA 


PLP 
JSR 
PLA 
STA 
PLA 
STA 
JMP 


JSR 
JSR 
JMP 
CLD 
JSR 
JSR 
JSR 
JSR 
LDA 
LDA 
LDY 
JSR 
NOP 
LDA 
BIT 
CLD 
JSR 
LDA 
EOR 
CMP 
BNE 
LDA 
BNE 
LDA 


$72 
$72 
$88 
$c8 
$c4 
$CA 
$26 
$48 
$44 
$44 
$A2 
$cB8 


$C3FA 
$45 


$45 
NEWLRO 


3 (D) FORMAT 


; (EZ) FORMAT 


jnew IRQ entry 


;(should never be used) 
3for those who save A to $45 
3;g0 to interrupt handler 


SETSLOTCXROM ;force in slots 


ACC 


SAVL 
PCL 


PCH 
(BRKV) 


INSDS1 
RGDSP1L 
MON 


SETNORM 
INIT 
SETVID 
SETKBD 
SETANO 
SETANL 
#9 
GOTOCX 


CLRROM 
KBDSTRB 


BELL 
SOFTEV+1 
#SAS 
PWREDUP 
PWRUP 
SOFTEV 
NOFIX 
#SE0 


;save accumulator 


SAVE REG'S ON BREAK 
3 INCLUDING PC 


;BRKV WRITTEN OVER BY DISK B800T 


;PRINT USER PC 

; AND REGS 

3GO TO MONITOR (NO PASS GO, NO $200!) 
3;DO THIS FIRST THIS TIME 


; ANO = TTL LO 

3 ANI = TTL Lo 
;CODE=INIT/RRAO981 

3D0 APPLEZE INIT/RRAO981 
;/RRAO981 

; TURN OFF EXTNSN ROM 

; CLEAR KEYBOARD 


3; CAUSES DELAY IF KEY BOUNCES 

31S RESET HI 

3A FUNNY COMPLEMENT OF THE 

; PWR UP BYTE 7??? 

; NO SO PWRUP 

; YES SEE IF COLD START 

; HAS BEEN DONE YET? 

3; DOES SOFT ENTRY VECTOR POINT AT BASIC? 


FA96:CD 
FA99:DO 
FA9B:A0 
FA9D:8C 
FAAN:4C 
FAA3:6C 
FAA6: 

FAA6:20 
FAA9: 

FAAS: A2 
FAAB: BD 
FAAE:9D 
FABL:CA 
FAB2:DO 
FAB4 : A9 
FAB6:86 
FAB8:85 
FABA: 

FABA: 

FABA: 

FABA: 

FABA:A0 
FABC:C6 
FABE:A5 
FACO:C9 
PAC2:FO 
FAC4:8D 
FAC7:Bl 
FAC9:D9 
FACC:DO 
FACE :88 
FACF:88 
FADO:10 
FAD2:6C 
FADS: 

FADS: FA 
FAD6:EA 
FAD?7: 

FAD7:20 
FADA:A9 
FADC:85 
FADE: A9 
FAEO:85 
FAE2:A2 
FAE4:A9 
FAE6:20 
FAE9:BD 
FAEC:20 
FAEF:A9 
FAF1:20 
PAF4:B5 
FAF6:20 
PAF9:E8 
PAFA:30 


05 
FC 
EF 


F7 
c8 


ol 


0s 
01 


co 
D7 
F8 


ol 
EC 


FS 
00 


FAA3 
03 
03 


FB 
FAA9 


FA 
03 


FAAB 


FASB 
07 


FB 
FABA 
FAC7 

00 


FD 


FA 


FD 
FD 


FAE4 


631 
632 
633 
634 
635 
636 
637 
638 
639 
640 
641 
642 
643 
644 
645 
646 
647 
648 
649 
650 
651 
652 
653 
654 
655 
656 
657 
658 
659 
660 
661 
662 
663 
664 
665 
666 
667 
668 
669 
670 
671 
672 
673 
674 
675 
676 
677 
678 
679 
680 
681 
682 
683 
684 


CMP SOFTEV+1 
BNE NOFIX ; YES SOQ REENTER SYSTEM 
FIXSEV LDY #3 3; NO SO POINT AT WARM START 
STY SOFTEV 3; FOR NEXT RESET 
JMP BASIC 3; AND DO THE COLD START 
NOFIX JMP (SOFTEV) ; SOFT ENTRY VECTOR 
ett titietiiticisd 
PWRUP JSR APPLEII 
SETPG3 EQU * ; SET PAGE 3 VECTORS 
LDx #5 
SETPLP LDA PWRCON-1,X ; WITH CNTRL B ADRS 
STA BRKV-1,X ; OF CURRENT BASIC 
DEX 
BNE SETPLP 
LDA #$C8 3 LOAD HI SLOT +1 
STX LOCO ; SETPG3 MUST RETURN X=0 
STA LOCL 3; SET PTR H 
* 
* Check 3 ID bytes instead of 4. Allows devices 
* other than Disk II's to be bootable. 
* 
SLOOP Lpy #5 3Y is byte ptr 
DEC LOCL 
LDA LOC] 
CMP #$CO 3; AT LAST SLOT YET? 
BEQ FIXSEV ; YES AND IT CAN'T BE A DISK 
STA MSLOT 
NXTBYT LDA (LOCO),Y ; FETCH A SLOT BYTE 
CMP DISKID-1,Y ; IS IT A DISK ?? 
BNE SLOOP ; NO, SO NEXT SLOT DOWN 
DEY 
DEY ; YES, SO CHECK NEXT BYTE 
BPL NXTBYT ; UNTIL 3 BYTES CHECKED 
JMP (LOCO) ; GO BOOT... 
* 
NOP 
NOP 
* 
REGDSP JSR CROUT ; DISPLAY USER REG CONTENTS 
RGDSPL LDA #$45 ;WITH LABELS 
STA A3L 
LDA #$00 
STA A3H 
LDX #$FB 
RDSP1 LDA #$A0 
JSR COUT 
LDA RTBL-251,X 
JSR COUT 
LDA #$BD 
JSR COUT 
LDA ACC+5,X 
JSR PRBYTE 
INK 
BMI RDSP1L 


6ee 


FAFC :60 
PAFD: 

FAFD:59 
FAFF :00 
FBO2:20 
FB06 :03 
FBO9:C1 
FBIIL: 

FB11:C4 
FBI4: FF 
FB16:FF 
FB19: 

FB19:C1 
FBLC: DO 
FBLE:AD 
FB21:A0 
FB23:EA 
FB24:EA 
FB25:BD 
FB28:10 
FB2A:C8 
FB2B: DO 
FB2D:88 
FB2E:60 
FB2F: 

FB2F:A9 
FB31:85 
FB33:AD 
PB36:AD 
FB39: AD 
FB3C:A9 
FB3E:FO 
FB40: AD 
FB43: AD 
PB46 :20 
FB49:A9 
FB4B:85 
FB4D:A9 
FB4F:85 
FB51:A0 
FB53: DO 
FB55:A9 
FB57:85 
FB59: A9 
FB5B:85 
FBSD:4C 
FB60: 

FB60:20 
FB63: AO 
FB65: BY 
FB6B:99 
FB6B:88 
FB6C: DO 
FB6E:60 


FA 
£0 
FF 
FF 
FO 


c2 
FF 
D8 
D3 


70 
00 


64 
04 


F8 


45 
00 
3c 
FO 
cl 
FF 
D9 


co 


co 


co 
co 
co 


co 
F8 


FC 


FC 


FF 


FF 


EC 
FBil 


FB2E 


FB25 


FB4B 


FBB4 


FB65 


685 
686 
687 
688 
689 
690 
691 
692 


* 
PWRCON 
DISKID 


XLTBL 


RTBL 


PREAD 


PREAD2 


RTS2D 


INIT 


SETTXT 


SETGR 


SETWND 


TABV 


* 
APPLEIL 


STITLE 


RTS 


DW 

DFB 
DFB 
DFB 
ASC 
EQU 
DFB 
DFB 
DFB 


DFB 
DFB 
LDA 
LDY 
NOP 
NOP 
LDA 
BPL 
INY 
BNE 
DEY 
RTS 


LDA 
STA 
LDA 
LDA 
LDA 
LDA 
BRQ 
LDA 
LDA 
JSR 
LDA 
STA 
LDA 
STA 
LDY 
BNE 
LDA 
STA 
LDA 
STA 


JSR 
LDY 
LDA 
STA 
DEY 
BNE 
RTS 


OLDBRK 
$00, $E0,$45 
$20,$FF,S00,SFF 
$03 ,$FF,$3C 
"Apple It" 
* 
$4 ,$C2,$C1 
SFF,$C3 
SFF,$FF,SFF 
$C1,$D8,$D9 ;REGISTER NAMES FOR REGDSP: 
$DO ,$D3 ; 'AXYPS' 
PTRIG ;TRIGGER PADDLES 
#$00 ; INIT COUNT 
;COMPENSATE FOR 1ST COUNT 
PADDLO,X ;COUNT Y-REG EVERY 12 USEC. 
RTS2D 
PREAD2 3EXIT AT 255 MAX 
#$00 ;CLR STATUS FOR DEBUG SOFTWARE 
STATUS 
LORES 
LOWSCR ;INIT VIDEO MODE 
TXTSET ;SET FOR TEXT MODE 
#$00 ;FULL SCREEN WINDOW 
SETWND 
TXTCLR ;SET FOR GRAPHICS MODE 
MIXSET ;LOWER 4 LINES AS TEXT WINDOW 
CLRTOP 
#814 
WNDTOP ;SET FOR 40 COL WINDOW 
#$00 ;TOP IN A-REG, 
WNDLFT ; BOTTOM AT LINE $24 
#Sc ;CODE=SETWND /RRAO981 
GOTOCX 
#518 
WNDBTM 
#$17 ;VTAB TO ROW 23 
cv ;VTABS TO ROW IN A-REG 
VTAB 
HOME ;CLEAR THE SCRN 
#9 
TITLE-1,Y ;GET A CHAR 
LINEI+14,Y ;PUT IT AT TOP CENTER OF SCREEN 
STITLE 


FBOF: 

FB6F:AD 
FB72:49 
FB74:8D 
FB77:60 
FB78: 

FB78: 

FB78:C9 
FB7A:D0 
FB7C: AC 
FB7F:10 
FB81:CO 
FB83:D0 
FB85:2C 
FB88: AC 
FB8B:10 
FB8D:CO 
FB8F: FO 
FB91:2C 
FB94 :4C 
FB97: 

FB97 :38 
FB98 :4C 
FB9B:A8 
FB9C: B9 
FB9F:20 
FBA2:20 
FBAS :C9 
FBA7: BO 
FBA9:C9 
FBAB:90 
FBAD:C9 
FBAF:FO 
FBB1:DO 
FBB3: 

FBB3: 

FBB3: 

FBB3: 

FBB3: 

FBB3:06 
FBB4: 

FBB4: 

FBB4 :2C 
FBB7 :08 
FBB8:8D 
FBBB:4C 
FBBE: 

FBBE:00 
FBBF:00 
FBCO: 

FBCO:E0 
FBC1: 

FBC1:48 
FBC2:4A 


F3 
AS 
F4 


2c 


48 
97 
21 
CE 
EE 
cg 
EA 
cc 
E6 
Es 


15 


07 
00 


03 


03 


FB78 


FB94 
co 
FB94 


FB94 
co 
co 
FBB8 


FB94 

co 

FB 

FC 

FA 

FB 

FD 
FB97 
FB97 


FB97 
FB9B 


co06 
c007 
co15 


FBB4 
co 


co 
cl 


SETPWRC LDA SOFTEV+1  ;ROUTINE TO CALCULATE THE ‘FUNNY 
EOR #$A5 ;COMPLEMENT' FOR THE RESET VECTOR 
STA PWREDUP 
RTS 
* 
VIDWAIT EQU * ;CHECK FOR A PAUSE (CONTROL-S). 
CMP #$8D ;ONLY WHEN I HAVE A CR 
BNE NOWAIT ;NOT SO, DO REGULAR 
LDY KBD ;IS KEY PRESSED? 
BPL NOWAIT ;NO. 
cPY #$93 sYES -- IS IT CTRL-S? 
BNE NOWAIT ;NOPE - IGNORE 
BIT KBDSTRB ;CLEAR STROBE 
KBDWAIT LDY KBD ;WAIT TILL NEXT KEY TO RESUME 
BPL KBDWAIT ;WAIT FOR KEYPRESS 
cPY #$83 ;IS IT CONTROL-C? 
BEQ NOWAIT ;YES, SO LEAVE IT 
BIT KBDSTRB 3CLR STROBE 
NOWAIT JMP VIDOUT 3D0 AS BEFORE 
* 
ESCOLD SEC ; INSURE CARRY SET 
JMP ESC1 
ESCNOW TAY ;USE CHAR AS INDEX 
LDA XLTBL-$C9,¥ ;TRANSLATE IJKM TO CBAD 
JSR ESCOLD ;DO THE CURSOR MOTLON 
JSR RDESC ;GET IJKM, ijkm, ARROWS/RRAO981 
ESCNEW CMP #$CE 31S THIS AN 'N'? 
BCS ESCOLD 3'N' OR GREATER - DO IT! 
CMP #$C9 ;LESS THAN 'I'? 
BCC ESCOLD 3YES, SO DO OLD WAY 
CMP #S$CC 31S IT AN 'L'? 
BEQ ESCOLD ;D0 NORMAL 
BNE ESCNOW 3GO DO IT 
* 
SETSLOTCXROM EQU $C006 ;/RRA0981 
SETINTCXROM EQU $CO07 =; /RRAO981 
RDCXROM EQU $CO15 3/RRAO981 
* /RRAOI81 
VERSION DFB $06 ;FOR IDCHECK/RRA0981 
* 
GoTOCK EQU * ;/RRAO981 
BIT RDCXROM ;GET CURRENT STATE/RRAO981 
PHP ;SAVE ROMBANK STATE/RRAO981 
STA SETINTCXROM ;SET ROMS ON/RRAOD981 
JMP C1ORG ;=>0FF TO CXSPACE/RRAO981 
* 
DFB O 
DFB O 
* 
ZIDBYTE DEB SEO 3//e ROM rev ID byte 
* 
BASCALC PHA ;CALC BASE ADDR IN BASL,H 
LSR A ;FOR GIVEN LINE NO. 


ove 


FBC3:29 
FBC5:09 
FBC7:85 
FBC9:68 
FBCA:29 
FBCC:90 
FBCE :69 
FBDO:85 
FBD2:0A 
FBD3:0A 
FBD4:05 
FBD6:85 
FBD8 :60 
FBD9: 

FBD9:C9 
FBDB: DO 
FBDD:A9 
FBDF :20 
FBE2:A0 
FBE4:A9 
PBE6:20 
FBE9: AD 
FBEC :88 
FBED:DO 
FBEF :60 
FBFO: 

FBFO:A4 
FBF2:91 
FBF4:56 
FBF6:A5 
FBF8:C5 
FBFA: BO 
FBFC:60 
FBFD: 

FBFD:C9 
FBFF: BO 
FCOL:A8 
FCO2:10 
FC04:C9 
FCO6: FO 
FC08:C9 
FCOA: FO 
FCOC:C9 
FCOE:DQ 
FC10:C6 
FC12:10 
FC14:A5 
FC16:85 
FC18:C6 
FCLA:A5 
FCLC:C5 
FCLE: BO 
FC20:C6 
FC22: 


24 


24 
24 


66 


ao 
EF 


8D 
SA 
BA 


88 
cg 


E8 
21 
24 
24 
25 


25 


FBDO 


FBEF 


FC 


FBE4 


FC62 


FBFO 
FBFO 
FC62 
FC66 
FBD9 


FBFC 


FBFC 


92 BASCLC2 


99 BELLI 


104 BELL2 


109 RTS2B 
110 * 
111 STORADV 


113 ADVANCE 


117 RTS3 
119 VIDOUT 


121 
122 
123 
124 
125 
126 
127 
128 
129 BS 
130 
131 
132 
133 
134 UP 
135 
136 
137 
138 * 


RTS 


LDY 
STA 
INC 
LDA 
CMP 
BCS 
RTS 


CMP 
BCS 
TAY 
BPL 
CMP 
BEQ 
CMP 
BEQ 
CMP 
BNE 
DEC 
BPL 


STA 
DEC 
LDA 
CMP 
BCS 
DEC 


#$03 
#$04 
BASH 


#$18 
BASCLC2 
#$7F 
BASL 

A 

A 

BASL 
BASL 


#887 
RTS2B 
#$40 
WAIT 
#$C0 
#$0C 
WAIT 
SPKR 


BELL2 


CH 
(BASL) ,Y 
CH 

CH 
WNDWDTH 
CR 


#$A0 
STORADV 


STORADV 
#$8D 

cR 

#S8A 
LF 

#588 
BELLI 
CH 

RTS3 
WNDWDTH 
CH 

cH 
WNDTOP 
cv 

RTS3 

Cv 


3; O<=LINE NO.<=$17 
;ARG = OOOABCDE, GENERATE 
; BASH = OOOOOICD 
; AND 
; BASL = EABABOOO 


;BELL CHAR? (CONTROL-G) 
; NO, RETURN. 

3 YES.ee 

;DELAY .01 SECONDS 


;TOGGLE SPEAKER AT 1 KHZ 
3; FOR .1 SEC. 


;CURSOR H INDEX TO Y-REG 
;STORE CHAR IN LINE 

; INCREMENT CURSOR H INDEX 
3 (MOVE RIGHT) 

; BEYOND WINDOW WIDTH? 
YES, CR TO NEXT LINE. 

3 NO, RETURN. 






3;CONTROL CHAR? 
; NO, OUTPUT IT. 
NVERSE VIDEO? 






; IF SO, DO IT. 

;BACK SPACE? (CONTROL-H) 

3 NO, CHECK FOR BELL. 
;DECREMENT CURSOR H INDEX 

;1F POSITIVE, OK; ELSE MOVE UP. 
;SET CH TO WINDOW WIDTH - 1. 


3(RIGHTMOST SCREEN POS) 
;CURSOR V INDEX 


;IF TOP LINE THEN RETURN 
;DECR CURSOR V INDEX 


FC22:A5 
FC24:85 
FC26:98 
FC27:A0 
FC29:DO 
FC2B: 

FC2B:EA 
FC2C: 

FC2C:49 
FC2E: FO 
FC30:69 
FC32:90 
FC34:FO 
FC36:69 
FC38:90 
FC3A:FO 
FC3C:69 
FC3E:90 
Fc40:D0 
FC42: 

FC42: 

FC42:A0 
FC44:D0 
FC46: 

FC46:2C 
FC49:10 
FC4B:A0 
FC4D: FO 
FC4F:98 
FC50:48 
FC51:20 
FC54:68 
FCS5:A4 
FC57 :60 
FC58: 

FCS8: 

FC58:A0 
FCSA:4C 
FCSD: 

FCSD:EA 
FCSE:EA 
FCSP:EA 
FC60:EA 
FC61:EA 
FC62: 

FC62:A9 
FC64:85 
FC66:£6 
FC68:A5 
FC6A:C5. 
FC6C:90 
FC6E:C6 
FC70: 

FC70: 


OA 
E3 


1F 
04 


OB 


78 


35 


FBB4 


FCS8 


FBF4 
FC10 


FC66 
FCLA 


FC9C 
FBFC 


FC42 
FC29 


co 
FC4F 
FCSA 


FB 


FC58 


FB 


FC24 


FC70 


139 
140 
141 
142 
143 
144 
145 
146 
147 
148 
149 
150 
151 
152 
153 
154 
155 
156 
157 
158 
159 
160 
161 
162 
163 
164 
165 
166 
167 
168 
169 
170 
171 
172 
173 
174 
175 
176 
177 
178 
179 
180 
181 
182 
183 
184 
185 
186 
187 
188 
189 
190 
191 
192 


VTAB LDA 
VTABZ STA 
TYA 
LDY 
GOTOCX] BNE 


NOP 


ESCcl EOR 
BEQ 


BCC 
BEQ 


BCC 
BEQ 
ADC 
BCC 
BNE 


CLREOP EQU 
LDY 
BNE 


NEWVW BIT 
BPL 
LDY 
BEQ 
NEWVWW1 = TYA 
PHA 
JSR 
PLA 
LDY 
RTS 


HOME EQU 
LDY 
GoTOCX3 JMP 


NOP 
NOP 
NOP 
NOP 
NOP 


cR LDA 
STA 
LF INC 
LDA 
CMP 
BCC 
DEC 
* 


SCROLL EQU 


cv 
BASL 


#$4 
GOTOCX 


RDSOVID 
NEWVWL 
#$0 
GOTOCX3 


VIDWAIT 


YSAV1 


#5 
GOTOCX 


#$00 


cv 

cv 
WNDBTM 
VTABZ 


3;GET CURSOR V INDEX 
;temporarily save Acc 
sand Y 
;this is VTABZ call 

3=> always perform call 


sESC '@'? 

IF SO DO HOME AND CLEAR 
ESC-A OR B CHECK 

A, ADVANCE 

B, BACKSPACE 
ESC-C OR D CHECK 

C, DOWN 

D, GO UP 

SC-E OR F CKECK 

, CLEAR TO END OF LINE 
LSE NOT F,RETURN 


E 


5 
3 
‘ 
> 
3 EB 
3 E 


;/RRAO9B1 
;CODE=CLREOP/RRA098 1 
3D0 40/80 /RRAO981 


jin 80 columns? 

;=>not 80 columns 
;Print a character 
;through video firmware 
;get masked character 
sand set up for vidwait 
sprint the character 
srestore Acc 

sand Y 


3/RRAO981 
; CODE*HOME/RRAO981 
3do 40/80 


;CURSOR TO LEFT OF INDEX 
;(RET CURSOR H=0) 
;INCR CURSOR V. (DOWN 1 LINE) 


3;OFF SCREEN? 
3; NO, SET BASE ADDR 
;DECR CURSOR V. (BACK TO BOTTOM) 


3/RRAO981 


lve 


FC70:A0 
FC72:D0 
FC74: 
FC74: 
FC74: 
FC74: 
FC74:8D 
FC77:6C 
FC7A: 
FC7A: 
FC7A: 
FC7A: 
FC7A:68 
FC7B:8D 
FC7E:C9 
FC80:90 
FC82:8D 
FC85:A0 
FC87 :A6 
FC89:85 
FC8B:B1 
FC8D:86 
FC8F:8D 
FC92:4C 
FC95: 
FC95:90 
FC97:25 
FC9934C 
FCc9C: 
FC9C: 
FC9C: 
Fcgc: 
Fc9c: 
FC9C: 
FC9C :38 
FC9D:90 
FC9E:18 
FCOF:84 
FCA1: AO 
FCA3: BO 
FCA5:C8 
FCA6:DO 
FCA8: 
FCA8:38 
FCA9:48 
FCAA:E9 
FCAC : DO 
FCAE :68 
FCAF:E9 
FCB1 :DO 
FCB3:60 
FCB4: 
FCB4:E6 
FCB6:DO 


06 
BS 


06 


co 


FE 03 


2A 


78 


75 


OL 
FC 


co 
cA 


FC29 


FC99 


0000 


FD1D 


FDID 


FCAA 


FCA9 


FCBA 


193 
194 
195 
196 
197 
198 
199 
200 
201 
202 
203 
204 
205 
206 
207 
208 
209 
210 
211 
212 
213 
214 
215 
216 
217 
218 
219 
220 
221 
222 
223 
224 
225 
226 
227 
228 
229 
230 
231 
232 
233 
234 
235 
236 
237 
238 
239 
240 
241 
242 
243 
244 
245 
246 


LDY #6 
BNE GOTOCX1 


3CODE=SCROLL/RRAO981 

3D0 40/80 /RRAO981 

* 

* Jump here to swap out ROMs 

* for interrupt handlers in peripheral cards 

* 

IRQUSER STA SETSLOTCXROM ;switch in slots 
JMP ($3FE) j;and jump to user 

* 

* IRQDONE ($C3F4) jumps here after interrupt 


* because this cannot be done from $Cn00 space 
* 


IRQDONE2 PLA sFix $C800 space 
STA MSLOT ;Testore MSLOT 
CMP #$CL svalid Cn? 
BCC IRQNOSLT 
STA $CFFF ;Deselect all $C800 
Lpy #0 
LDX $1 
STA $1 
LDA ($0),Y 3do $Cn00 reference 
SsTx $1 ;fix zp location 
IRQNOSLT STA SETINTCXROM 
JMP IRQFIX sand restore the machine state 
* 
DOCOUT1] BCC DOCOUT2 jdon't mask controls 
AND INVFLG japply inverse mask 
DOCOUT2 JMP COUTZI1 ;g0 back to COUTI 
* 
DS  F8ORG+$49C-*,0 ;pad to clreol 
* 
* Note: bytes CLREOL and CLREOLZ ($38 and $18) 
* are used by slot test at $FBB7. 
* 
CLREOL SEC ;say it is EOL 
DFB $90 ;*BCC' opcode 
CLREOLZ CLC 3;say it is EOLZ 
STY BAS2L ;save Y in temp 
Loy #7 jcode=CLREOL 
BCS GOTOCX2 jdo it 
INY jcode 8=CLREOLZ 
BNE GOTOCX2 
* 
WAIT SEC jenter with count in A 
WAIT2 PHA sdelay is: 
WAIT3 SBC #$01 
BNE WAIT3 313+11*A+5*A*A cycles 
PLA 3@ 1.023 usec per cycle 
SBC #$01 
BNE WAIT2 
RTS 
* 
NXTAG INC A4L ;INCR 2-BYTE A4 
BNE NXTAL 3; AND Al 


FCB8:E6 
FCBA:A5 
FCBC:C5 
FCBE: AS 
FCCO:E5 
FCC2:E6 
FCc4:DO 
FCC6:E6 
FCC8 :60 
FCC9: 

FCC9:8D 
FCCC :20 
FCCF:4C 
FCD2: 

FCD2: 

FCD2: 

FCD2: 

FCD2: 

FCN2: 

FCD2:8D 
FCD5:20 
FCD8:A9 
FCDA:20 
FCDD:20 
FCEO:4C 
FCE3: 

FCE3 :8D 
FCE6:20 
FCE9:20 
FCEC :84 
FCEE:85 
FCFO: 

FCFO: 

FCFO: 

FCFO: 

FCFO:A9 
FCF2:85 
FCF4:20 
FCF7 :8D 
FCFA:4C 
FCFD: 

FCFD:B9 
FDOO:c8 
FDO1:c9 
FDO3:90 
FDOS:c9 
FDO7: BO 
FDO9:29 
FDOB:60 
FDOC: 

FDOC: AO 
FDOE:DO 
FD10:4¢ 
FD13:20 


43 
3c 
3E 
3D 
3F 
3¢ 
02 
3D 


07 
67 
cs 


06 
4A 
DE 
ED 
3A 
FO 


OB 
03 
18 
B4 


co 
cs 
FE 


co 
F9 


FD 
FF 


co 
F8 


co 
CF 


02 


FD 
FB 


FCC8 


FDOB 


FDOB 


FD13 


247 
248 
249 
250 
251 
252 
253 
254 
255 
256 
257 
258 
259 
260 
261 
262 
263 
264 
265 
266 
267 
268 
269 
270 
271 
272 
273 
274 
275 
276 
277 
278 
279 
280 
281 
282 
283 
284 
285 
286 
287 
288 
289 
290 
291 
292 
293 
294 
295 
296 
297 
298 
299 
300 


NXTA1 


RTS4B 


HEADR 


INC 
LDA 
CMP 
LDA 
SBC 
INC 
BNE 
INC 
RTS 


STA 
JSR 
SMP 


AGH 

AlL ;1NCR 2-BYTE Al. 
A2L ; AND COMPARE TO A2 
AlH 3 (CARRY SET IF >=) 
A2H 

AIL 

RTS4B 


AlH 


SETINTCXROM ;force internal ROM 
XHEADER jwrite header 
RETCXL ;force slots and return 


* For the disassembler to be able to do 1/0 to slots, 
* it cannot make calls to the I/O routines with the 


* internal ROM switched in. 


This stuff switches the 


* ROM out for such instances. 


* 
ERR3 


* 
DISLIN 


eee Oe 


GETINST] LDA #SAl 


UPMON 


UPMON2 


RDKEY 


FD1O 
RDKEYO 


STA 
JSR 
LDA 
JSR 
JSR 
JMP 


STA 
JSR 
JSR 
STY 
STA 


STA 
JSR 
STA 
IMP 


LDA 
INY 
CMP 
BCC 
CMP 
BCS 
AND 
RTS 


LDY 


JMP 
JSR 


SETSLOTCXROM ;force slot ROM 


PRBL2 stab to the error 

#$DE j;to print a caret "“" 

COUT sprint it 

BELL sand beep 

GETINSTL j;and go get next instruction 


SETSLOTCXROM ;force slot ROM 


INSTDSP jdisassemble the instruction 
PCADJ ;calculate new PC 

PCH jand update PC 

PCL 


NOTE: The entry point GETINST1 is hard-coded in 
BFUNC of the Video firmware. 


3get mini~prompt 
PROMPT 

GETLNZ 3g0 get a line of input 
SETINTCXROM ;force internal ROM 


DOINST sand return to CX space 
IN,Y sget character 

;point to next char 
#SEL sis it lowercase? 
UPMON2 3=>nope 
#SFB jlowercase? 
UPMON2 3™=>nope 
#SDF jelse upshift 
#SB 3;code=RDKEY 
RDKEYO 3allow $FD10 entry 
RDKEY1 3if enter here, do nothing 
GOTOCX j;display cursor 


ove 


FD16:EA 
FD17:EA 
FD18:6C 
FDIB: 
FDIB: 


" FDIB:A0 


FDID:4C 
FD20:EA 
F021: 
FD21: 
FD21:20 
FD24:A0 
FD26:DO 
FD28: 
FD28: 
FD28: 
FD28: 
FD28: 
FD28: 
FD28:4E 
FD2B:4C 
FD2E:EA 
FD2F: 
FD2F:20 
FD32:20 
FD35:20 
FD38:C9 
FD3A:FO 
FD3C 360 
FD3D: 
FD3D:A0 
FD3F:20 
FD42:A4 
FD44:9D 
FD47: 


FD47:20 
FD4A:EA 
FD4B:EA 
FD4C : EA 
FD4): BD 
FD50:C9 
FD52:FO 
FD54:C9 
FD56: FO 
FD58:E0 
FD5A:90 
FD5C:20 
FDSF:E8 
FD60:D0 
FD62: 

FD62:A9 
FD64:20 
FD67 320 


38 


03 
B4 


oc 


FS 


ED 


00 
88 
iD 


OA 
F8 


3A 


13 


ED 


00 


FDIB 


FB 


FD21 


FDID 


07 


FD 


FD 


FD 


FD2F 


FB 


02 


FD 


02 


FD71 


FD62 


FDSF 


FD75 


FD 
FD 


301 
302 
303 
304 
305 
306 
307 
308 
309 
310 
311 
312 
313 
314 
315 
316 
317 
318 
319 
320 
321 
322 
323 
324 
325 
326 
327 
328 
329 
330 
331 
332 
333 
334 
335 


336 
337 
338 
339 
340 
341 
342 
343 
344 
345 
346 
367 
348 
349 
350 
351 
352 
353 


NOP 
NOP 

RDKEY1 JMP 

* 

KEYIN EQU 
LDY 

GOTOCX2 JMP 
NOP 

* 

RDESC EQU 
JSR 
LDY 
BNE 


* 


(KSWL) 


* 
#3 
GOTOCX 


* 
RDKEY 
#1 
GOTOCX2 


;GO TO USER KEY-IN 


; RDKEY/RRAO981 
;/RRAO981 
3/RRA0981 


3GET A KEY 
3CODE=FIXIT 
3=>always 


* Flag to the video firmware that escapes are allowed. 
* This routine is called by RDCHAR which is called by 


GETLN. 


The high bit of MSLOT is set by all cards 


* 
* that use the C800 space. 
* 


NEWRDKEY LSR MSLOT 


JMP 

NOP 
ESC JSR 
JSR 
JSR 
CMP 
BEQ 
RTS 


RDCHAR 


* 


PICKFIX LDY 
JSR 
LDY 
STA 
*#03 AUTOST2Z 
NOTCR JSR 
NOP 
NOP 
NOP 
LDA 
CMP 
BEQ 
CMP 
BEQ 
CPX 
BCC 
JSR 
INK 
BNE 


NOTCRI 


* 
CANCEL LDA 
JSR 


GETLNZ JSR 


RDKEY 


RDESC 
ESCNEW 
NEWRDKEY 
#S9B 

ESC 


#SF 
GOTOCX 
cH 
IN,X 


cout 


IN,X 
#$88 
BCKSPC 
#$98 
CANCEL 
#SF8 
NOTCRI 
BELL 


NXTCHAR 
#$DC 


couUT 
CROUT 


3<128 means escape allowed 
snow read the key 


;/RRAO981 

; HANDLE ESC FUNCTION. 
3;Flag RDCHAR and read key 
;*ESC'? 

3; YES, DON'T RETURN. 


jscode = fixpick 

3do 80 column pick 
srestore Y 

sand save new character 


Auto-Start Monitor ROM 27-AUG-84 PAGE 20 


3;echo typed char 


;CHECK FOR EDIT KEYS 
3 — BACKSPACE 


3 — CONTROL-X 


; YES, SOUND BELL 
;ADVANCE INPUT INDEX 


;BACKSLASH AFTER CANCELLED LINE 


;OUTPUT CR‘ 


FD6A:A5 
FD6C:20 
FD6F : A2 
FD71:8A 
FD72:FO 
FD74:CA 
FD75:20 
FD78:C9 
FD7A:DO 
FD7C:B1 
FD7E:2C 
FD81:30 
FD83:EA 
FD84:9D 
FD87 :C9 
FD89:DO 
FD8B:20 
FD8E:A9 
FD90: DO 
FD92: 

FD92:A4 
FD94:A6 
FD96:20 
FD99:20 
FD9C:A0 
FD9E: A9 
FDAO:4C 
FDA3: 

FDA3: AS 
FDA5:09 
FDA7 :85 
FDA9:A5 
FDAB:85 
FDAD: A5 


3c 
07 
3E 
3D 
3F 
3c 


D8CHK LDA 


FDAF:29 
FDB1: DO 
FDB3:20 
FDB6:A9 
FDB8 :20 
FDBB: Bl 
FDBD:20 
FDCO:20 
FDC3:90 
FDC5:60 
FDC6: 

FDC6:4A 
FDC7:90 
FDC9:4A 
FDCA:4A 
FDCB:A5 
FDCD:90 
FDCF:49 
FDD1:65 


EA 


3E 
02 
FF 


FD 


FD67 
FD 
FD84 


co 
FD3D 


02 


FD47 
FC 


FDED 


FD 


F9 


FD 


ALL 


FDB6 
FD 


FO 


FDAD 


FDB3 


FDDL 


GETLN 
BCKSPC 


NXTCHAR 


ADDINP 


CROUT 


PRAL 


PRYX2 


XAM8 


MO 


XAM 
DATAOUT 


RTS4C 
* 


XAMPM 


ADD 


STA 
LDA 
STA 


AND 
BNE 
JSR 
LDA 
JSR 
LDA 
JSR 
JSR 
BCC 
RTS 


LSR 
BCC 
LSR 
LSR 
LDA 
BCC 
EOR 


PROMPT 3;OUTPUT PROMPT CHAR 

COUT 

#$01 ;INIT INPUT INDEX 

GETLNZ ;WILL BACKSPACE TO 0 

RDCHAR 

#$95 ;USE SCREEN CHAR 

ADDINP ; FOR CONTROL-U 

(BASL),Y ;do 40 column pick 

RDBOVID 380 columns? 

PICKFIX ;=>yes, fix it 

IN,X 3;ADD TO [INPUT BUFFER 

#$8D 

NOTCR 

CLREOL ;CLR TO EOL IF CR 

#$8D 

cout 3 (ALWAYS) 

ALH 3;PRINT CR,Al IN HEX 

ALL 

CROUT 

PRNTYX 

#S00 

#SAD ;PRINT '-'" 

cout 

ALL 

#$07 ;SET TO FINISH AT 

A2L 3; MOD 8=7 

AlH 

A2H 

#$07 

DATAOUT 

PRAL 

#$A0 

COUT ;OUTPUT BLANK 

(AIL),Y 

PRBYTE 3;OUTPUT BYTE IN HEX 

NXTAL 

MOD8CHK ;NOT DONE YET. GO CHECK MOD 8 
3 DONE. 

A ;DETERMINE IF MONITOR MODE IS 

XAM ; EXAMINE, ADD OR SUBTRACT 

A 

A 

A2L 

ADD 

#SFF ;FORM 2'S COMPLEMENT FOR SUBTRACT. 

ALL 


eve 


FDD3:48 
FDD4:A9 
FDD6:20 
FDD9: 68 
FDDA:48 
FDDB:4A 
FDDC:4A 
FDDD:4A 
FDDE:4A 
FDDF:20 
FNE2:68 
FNE3:29 
FDE5:09 
FDE7:C9 
FDE9:90 
FOEB:69 
FDED: 

FDED: 6C 
FDFO: 

FDFO:48 
FDF1:C9 
FDF3:4C 
FDF6: 

FDF6:48 
FDF7:84 
FDF9: AB 
FDFA:68 
FDFB:4C 
FDFE: EA 
FDFF:EA 
FEOO: 

FEOO:C6 
FEO2: FO 
FEO4:CA 
FEO5S: DO 
FEO7:C9 
FEO9:DO 
FROB:85 
FEOD: AS 
FEOF:91 
FELL:E6 
FE13:DO 
FEL5;E6 
FE17:60 
FE18: 

FE13:A4 
FE1A:B9 
FE1D:85 
FEIF:60 
FE20: 

FE20:A2 
FE22:85 
FE24:95 
FE26:95 


BD 
ED 


ES 
OF 


BA 
02 
06 


36 


ao 


46 


34 
oF 


16 
BA 
BB 
31 


40 
40 
02 
41 


34 
FF 
31 


o1 
3E 
42 
44 


FD 


FD 


FC 


Fc 


ol 


FDED 


FDA3 


FEID 


FE17 


407 
408 
409 
410 
ail 
412 
413 
414 
415 
416 
417 
418 
419 
420 
421 
422 
423 
424 
425 
426 
427 
428 
429 
430 
431 
432 
433 
434 
435 
436 
437 
438 
439 
440 
Al 
442 
443 
4b4 
445 
446 
447 
448 
449 
450 
451 
452 
453 
454 
455 
456 
457 
458 
459 
460 


PRBYTE 


PRHEX 
PRHEXZ 


COUT 


cout. 


COUTZ 
cOuUTZ1 


BLI 


BLANK 


STOR 


RTSS 


SETMODE 


SETMDZ 


LT 
LT2 


PHA 


JSR 
PLA 
PHA 
LSR 
LSR 
LSR 
LSR 
JSR 
PLA 
AND 
ORA 
CMP 
BCC 


JMP 


PHA 
CMP 
JMP 


PHA 
STY 
TAY 
PLA 
NOP 
NOP 
DEC 
BEQ 
DEX 
BNE 
CMP 
BNE 
STA 
LDA 
STA 
INC 
BNE 
INC 
RTS 


LDY 
LDA 
STA 
RTS 


LDX 
LDA 
STA 
STA 


#SBD 
couUT 


(CSwL) 


#$A0 
DOCOUT1 H 


YSAV1 


NEWVW 


YSAV 
XAM8 


SETMDZ 
#SBA 
XAMPM 
MODE 


(A3L),Y 
A3L 
RTSS 
A3H 


YSAV 
IN-1,¥ 
MODE 


#301 

A2L,X 
AGL, X 
ASL,X 


;PRINT '=', THEN RESULT 


PRINT BYTE AS 2 HEX DIGITS 
(DESTROYS A-REG) 


;PRINT HEX DIGIT IN A-REG 
;LSBITS ONLY. 


;VECTOR TO USER OUTPUT ROUTINE 


;save original character 
sis it a control? 
=>mask if not; return to COUTZ) 


;save original character 
;save Y 

;save masked character 
3get original char 
snew entry to vidwait 


;BLANK TO MON 
;AFTER BLANK 

;DATA STORE MODE? 

; NO; XAM, ADD, OR SUBTRACT. 
;KEEP IN STORE MODE 


;STORE AS LOW BYTE AT (A3) 


;INCR A3, RETURN. 


;SAVE CONVERTED ':', ‘+', 
"=", '.' AS MODE 


;COPY A2 (2 BYTES) TO 
3; A4 AND AS 


FE28:CA 
FE29:10 
FE2B:60 
FE2C: 

FE2C: Bl 
FE2E:91 
FE30:20 
FE33:90 
FE35:60 
FE36: 

FE36: BL 
FE38:D1 
FE3A:FO 
FE3C:20 
FE3F: Bl 
FE41:20 
FE44:A9 
FE46:20 
FE49:A9 
FE4B:20 
FE4E:Bl 
FE50:20 
FES3:A9 
FE55:20 
FE58:20 
FE5B:90 
FESD:60 
FESE: 

FE5E:20 
FE61:A9 
FE63:48 
FE64:20 
FE67:20 
FE6A:85 
FE6C:84 
FE6E:68 
FE6F:38 
FE70:E9 
FE72:D0 
FE74:60 
FE75: 

FE75:8A 
FE76:FO 
FE78:B5 
FE7A:95 
FE7C:CA 
FE7D:10 
FE7F:60 
FE80: 

FE80: AO 
FE82:DO 
FE84:A0 
FE86:84 
FE88 :60 


F7 


3c 
42 


F7 


3c 
42 
ic 


3c 
DA 


ED 
A8 
ED 
42 
DA 
Ag 
ED 
B4 
bo 


75 
14 
DO 
3A 
3B 


ol 
EF 


07 
3c 
3A 


F9 


FE22 


FC 
FE2C 


FES8 
FD 


FD 
FD 
FD 


FD 
FC 
FE36 


FE 


F8 
F9 


FE63 


FE7F 


FE78 


FE86 


461 
462 
463 
464 
465 
466 
467 
468 
469 
470 
471 
472 
473 
474 
475 
476 
477 
478 
479 
480 
481 
482 
483 
484 
485 
486 
487 
488 
489 
490 
491 
492 
493 
494 
495 
496 
497 
498 
499 
500 
501 
502 
503 
504 
505 
506 
507 
508 
509 
510 
511 
512 
513 
514 


MOVE 


VFY 


VFYOK 


LIST 


LIST2 


ALPC 


ALPCLP 


ALPCRTS 
* 


SETINV 


SETNORM 
SETIFLG 


DEX 
BPL 
RTS 


LDA 
STA 
JSR 
BCC 
RTS 


LDA 


BEQ 
JSR 
LDA 
JSR 


JSR 
LDA 
JSR 
LDA 
JSR 
LDA 
JSR 
JSR 
BCC 
RTS 


JSR 
LDA 
PHA 
JSR 
JSR 
STA 
STY 
PLA 
SEC 
SBC 
BNE 
RTS 


TXA 
BEQ 
LDA 
STA 
DEX 
BPL 
RTS 


LDY 
BNE 
LDY 
STY 
RTS 


LT2 


(A1L),¥ 
(AaL),Y 
NXTA4 
MOVE 


(ALL),¥ 
(ASL) ,Y 
VFYOK 
PRAI 
(AIL),Y 
PRBYTE 
#$A0 
COUT 
#SA8 
COUT 
(A4L),Y 
PRBYTE 
#SA9 
COUT 
NXTAS 
VFY 


AlPc 
#$14 


INSTDSP 
PCADJ 
PCL 

PCH 


#$01 
LIST2 


ALPCRTS 
ALL,X 
PCL,X 


ALPCLP 


#$3F 
SETIFLG 
#SFF 
INVFLG 


;MOVE (AL) THRU (A2) TO (A4) 


;VERLFY (Al) THRU (A2) 
3 WITH (A4) 


;MOVE Al (2 BYTES) To 
3; PC IF SPEC'D AND 
; DISASSEMBLE 20 INSTRUCTIONS. 


;ADJUST PC AFTER EACH INSTRUCTION, 


;NEXT OF 20 INSTRUCTIONS 


;IF USER SPECIFIED AN ADDRESS, 
3; COPY IT FROM Al TO PC. 
;YEP, SO COPY IT. 


;SET FOR INVERSE VID 
; VIA COUTL 
;SET FOR NORMAL VID 


pre 


FE89: 
FE89: A9 
FE8B:85 
FE8D: A2 
FE8F:A0 
FE91:DO 
FE93: 
FE93:A9 
FE95:85 
FE97:A2 
FE99: AO 
FE9B:A5 
FE9D:29 
FE9F:FO 
FEA] :09 
FEA3: AO 
FEAS :94 
FEA7:95 
FEA9: AO 
FEAB:4C 
FEAE: 
FEAE: EA 
FEAF :00 
FEBO: 
FEBO:4C 
FEB3:4C 
FEB6:20 
FEB9:20 
FEBC:6C 
FEBF:4C 
FEC2:60 
FEC3:EA 
FEC4 :60 
FECS: 
FECS: 
FEC5: 
FEC5: 
FEC5: 
FECS: 
FEC5:8D 
FEC8:60 
FEC9:EA 
FECA: 
FECA:4C 
FECD: 
FECD:A9 
FECF:8D 
FED2:20 
FEDS: FO 
FED7: 
FED7: 
FED7: 
FED?7: 
FED7: 


00 


75 
3F 


D7 


06 


F8 


40 
07 


2c 


FE9B 


FEAS 


FB 


EO 


FF 


FA 


co 


515 
516 
517 
518 
519 
520 
521 
522 
523 
524 
525 
526 
527 
528 
529 
530 
531 
532 
533 
534 
535 
536 
537 
538 
539 
540 
541 
542 
543 
544 
545 
546 
547 
548 
549 
550 
551 
552 
553 
554 
555 
556 
557 
558 
559 
560 
561 
562 
563 
564 
565 
566 
567 
568 


* 


SETKBD LDA 
INPORT STA 
INPRT- LDX 
LDY 
BNE 
* 
SETVID LDA 
OUTPORT STA 
OUTPRT LDX 
LDY 
IOPRT LDA 
AND 
BEQ 
ORA 
LDY 
IOPRT1 STY 
STA 
LDY 
GOTOCX4 JMP 
* 
NOP 


CKSUMFIX DFB 0 


#$00 ;DO 'IN#O' 

A2L ;DO 'IN#AREG' 

#KSWL 

#KEYIN 

IOPRT 

#$00 ;DO *PR#O' 

A2L 3DO 'PR#AREG' 

#CSWL 

#COUTI 

A2L ;SET INPUT/OUTPUT VECTORS 
#S0F 

LOPRT1 

#<IOADR 

#$00 

Loco ,X ;save low byte of hook 
LOocl1,X ;S8ave acc 

#SE ;code=PR#/ IN# 

GOTOCK ;perform call 


;/RRAO981 


* j77>CORRECT CKSUM AT CREATE TIME. 


XBASIC JMP 
BASCONT JMP 
co JSR 

JSR 

IMP 
REGZ JMP 
TRACE RTS 

NOP 
STEPZ2 RTS 
* 


BASIC ;TO BASIC, COLD START 
BASIC2 ;TO BASIC, WARM START 
ALPC ;ADDR TO PC IF SPECIFIED 
RESTORE ;RESTORE FAKE REGISTERS 
(PCL) ;AND GO! 
REGDSP 3;GO DISPLAY REGISTERS 
;TRACE IS GONE 
;STEP IS GONE 


* Return here from GOTOCX 


* 


* NOTE: This address is hard-coded in BFUNC of the 
* video firmware 


* 


RETCX1 
RETCX2 


STA 
RTS 
NOP 
* 


USR JMP 
* 


WRITE 
WRT2 


LDA 
STA 
JSR 
BEQ 


ee ee 


SETSLOTCXROM ;restore bank 
;simply return 


USRADR ;JUMP TO CONTROL-Y VECTOR IN RAM 
#$40 

SETINTCXROM ;set internal ROM 

WRITE2 swrite to tape 

RD2 ;*>always set slots, beep 


SEARCH is called with a Monitor command of the form 

HHLL<ADRI.ADR2 in which ADR1 < ADR2 and LL precedes HH 
in memory. 
the single byte LL is searched for. 


If HH is 0, or omitted (LL<ADRI1-ADR2), then 
You cannot search for 


FED7: 

FED?: 

FED?7: 

FED7 :A0 
FED9: AS 
FEDB:FO 
FEDD: DL 
FEDF:DO 
FEE] :88 
FEE2:A5 
FEE4:D1 
FER6 : DO 
FEE8:20 
FEEB:20 
FEEE:90 
FEFO:60 
FEF1: 

FEF1:A0 
FEF3;20 
FEF6: 

PEF6:20 
FEF9:68 
FEFA:68 
FEFB:DO 
FEFD: 

FEFD:8D 
FFOO:20 
FFO3:8D 
FFO6: FO 
FFO8:DO 
FFOA: 

FFOA:CL 
FFL3: 

FF13: 

FF13: 

FF13:20 
FF16:C9 
FFL8:FO 
FF1A:60 
FFLB: 

FF1B: BO 
FFID:C9 
FFLF:DO 
FF21:B9 
FF24:A2 
FF26:C9 
FF28:FO 
FF2A:C8 
FF2B:D0 
FF2D: 

FF2D:A9 
FF2F:20 
FF32:A9 
FF34:20 


oO. 


04 
3c 
OA 


42 
3c 
03 
92 
BA 
E7 


oD 


00 


6c 


07 
Dl 
06 
32 
23 


FO 


cs 
ED 
D2 
ED 


FEEL 


FEEB 


FEEB 
FD 
FC 
FED? 


FB 


FE 


FF69 

co 

cs 

co 
FF3A 
FF2D 


FO EC 


FC 


FF13 


FF8A 


FF49 


02 


FFA7 


FF9O 


FD 


569 
570 
571 
572 
573 
574 
575 
576 
577 
578 
579 
580 
581 
582 
583 
584 
585 
586 
587 
588 
589 
590 
591 
592 
593 
594 
595 
596 
597 
598 
599 
600 
601 
602 
603 
604 
605 
606 
607 
608 
609 
610 
611 
612 
613 
614 
615 
616 
617 
618 
619 
620 
621 
622 


* a two byte pair with a high byte of 0. 


A list of all 


* adresses containing the specified pattern is displayed. 


* 

SEARCH LDY 
LDA 
BEQ 
CMP 
BNE 
DEY 
LDA 
CMP 
BNE 
JSR 
JSR 
BCC 
RTS 


SRCH1 


SRCH2 


MINI LDY 
JSR 


CRMON 


READ 


RD2 


* 


TITLE 
* 


* NNBL gets 
* 


NNBL 


ASC 


JSR 


* 
LOOKASC BCS 


PRERR 


#1 jset Y to 1 
ASH zis high byte 0? 
SRCH1 3™>yes, only look for low byte 
(AIL),¥ ;check high byte first 
SRCH2 3=>no match, try next byte 

;match, now check low byte 
ASL 3get low byte 
(ALL) ,Y¥ jdoes it match? 
SRCH2 ;™>no match, try next byte 
PRAI ;bytes match, print address 
NXTAL jincrement address 
SEARCH ;set Y back to 1 
#sp ;dispatch mini-assembler call to 
GOTOCX sget internal ROM switched in 
BLI ;HANDLE CR AS BLANK 

; THEN POP STACK 

3 AND RETURN TO MON 
MONZ 3 (ALWAYS) 


SETINTCXROM ;set internal ROM 
XREAD 3;do tape read 
SETSLOTCXROM ;restore slot CX 


BELL sread (write) ok, beep 
PRERR ;error, print message 
“Apple /le" 


the next non-blank for the mini-assembler 


UPMON j;get char, upshift, INY 
#SA0 jis it blank? 
NNBL syes, keep looking 
DIG jit was a digit 
#SA0 scheck for quote (') 
RTS6 smope, return char 
$200,Y jelse get next char 
#7 ;for shifting asc into A2L and A2H 
#$8D jwas it CR? 
GETNUM syes, go handle CR 
s;advance index 
NXTBIT 3™=>(always) into A2L and A2H 
#8C5 ;PRINT "ERR', THEN FALL INTO 
couT 3 FWEEPER. 
#$D2 
couT 


sve 


FF37:20 
FF3A: 

FF3A:A9 
FF3C:4C 
FE3F: 

FF3F:A5 
FF41:48 
FF42:A5 
FF44:A6 
FF46:A4 
FF48:28 
FF49:60 
FF4A: 

FF4A:85 
FF4C:86 
FF4E:84 
FF50:08 
FF51:68 
FF52:85 
FF54:BA 
FF55:86 
FF57:D8 
FF58:60 
FF59: 

FF59:20 
FF5C:20 
FFSF:20 
FF62:20 
PF65: 

FF65:D8 
FF66:20 
FF69:A9 
FF6B:85 
FF6D:20 
FF70:20 
FF73:20 
FF76:84 
FF78:A0 
FF7A:88 
FF7B:30 
FF7D:D9 
FF80:D0 
FF82:20 
FF85:A4 
FF87:4C 
FF8A: 

FF8A:A2 
FF8C:0A 
FF8D:0A 


_ FF8E:0A 


FF8F:0A 
FF90:0A 
FF91:26 
FF93:26 


ED 


87 
ED 


48 


3E 
3F 


FD 


FD 


FE 
FB 
FE 
FE 


FF 


FD 
FF 
FF 


FF65 
FE 

FF7A 
FF 


FF 


623 
624 
625 
626 
627 
628 
629 
630 
631 
632 
633 
634 
635 
636 
637 
638 
639 
640 
641 
642 
643 
644 
645 
646 
647 
648 
649 
650 
651 
652 
653 
654 
655 
656 
657 
658 
659 
660 
661 
662 
663 
664 
665 
666 
667 
668 
669 
670 
671 
672 
673 
674 
675 
676 


* 
BELL 


* 


RESTORE 


RESTRL 


RTS6 
* 


SAVE 
SAV1 


* 


OLDRST 


MON 


MONZ 


NXTITM 


CHRSRCH 


DIG 


NXTBIT 


JSR 


LDA 


LDA 
PHA 


LDX 
LDY 
PLP 
RTS 


STA 
STX 
STY 
PHP 
PLA 
STA 
TSX 
STX 
cLD 
RTS 


JSR 
JSR 
JSR 
JSR 


CLD 
JSR 
LDA 
STA 
JSR 
JSR 
JSR 
STY 
LDY 
DEY 


BNE 
JSR 


JMP 


LDX 
ASL 
ASL 
ASL 
ASL 
ASL 
ROL 
ROL 


COUT 


#$87 
cout 


STATUS 


ASH 
XREG 
YREG 


ASH 
XREG 
YREG 


STATUS 


SPNT 


SETNORM 
INIT 
SETVID 
SETKBD 


BELL 
#SAA 
PROMPT 
GETLNZ 
ZMODE 
GETNUM 
YSAV 
#$17 


MON 
CHRTBL,Y 
CHRSRCH 
TOSUB 
YSAV 
NXTITM 


#$03 


;MAKE A JOYFUL NOISE, THEN RETURN. 


RESTORE 6592 REGISTER CONTENTS 
USED BY DEBUG SOFTWARE 


;SAVE 6502 REGISTER CONTENTS 
; FOR DEBUG SOFTWARE 


;SET SCREEN MODE 
; AND INIT KBD/SCREEN 
; AS I/O DEVS. 


;MUST SET HEX MODE! 
3 FWEEPER. 
3'*' PROMPT FOR MONITOR 


;READ A LINE OF INPUT 

;CLEAR MONITOR MODE, SCAN IDX 
;GET ITEM, NON-HEX 

3 CHAR IN A-REG. 

3; X-REG=0 IF NO HEX INPUT 


;COMMAND NOT FOUND, BEEP & TRY AGAIN. 
;FIND COMMAND CHAR IN TABLE 

;NOT THIS TIME 

3GOT IT! CALL CORRESPONDING SUBROUTINE 
;PROCESS NEXT ENTRY ON HIS LINE 


;GOT HEX DIGIT, 
; SHIFT INTO A2 


FF95:CA 
FF96:10 
FF98:A5 
FF9A:DO 
FF9C:B5 
FF9E:95 
FFAO:95 
FFA2:E8 
FFA3:FO 
FFAS :DO 
FFA7;: 

FFA7:A2 
FFA9:86 
FFAB:86 
FFAD:20 
FFBO:EA 
FFB1:49 
FFB3:C9 
FFB5:90 
FFB7 :69 
FFB9:C9 
FFBB:4C 
FFBE: 

FFBE:A9 
FFCO:48 
FFC1:B9 
FFC4 :48 
FFCS:A5 
FFC7:A0 
FFC9:84 
FFCB:60 
FFCC: 

FFCC: BC 
FFCD: B2 
FFCE:BE 
FFCF:9A 
FFDO:EF 
FFD1:C4 
FFD2:EC 
FFD3:A9 
FFD4:BB 
FFD5:A6 
FFD6: A4 
FFD7:06 
FFD8:95 
FFD9:07 
FFDA:02 
FFDB:05 
FFDC:FO 
FFDD:00 
FFDE:EB 
FFDF:93 
FFEO:A7 
FFE1:C6 


F8 
31 
06 
3F 


41 


F3 
06 


00 
3E 
3F 
FD 


OA 
D3 
88 
FA 
1B 


FE 
E3 
31 


00 
31 


FC 


FF 


FF 


FF9O 


FFA2 


FF98 
FFAD 


FF8A 


677 
678 
679 


681 
682 
683 
684 
685 
686 
687 
688 
689 
690 
691 
692 
693 
694 
695 
696 
697 
698 
699 
700 
701 
702 
703 
704 
705 
706 
707 
708 
709 
710 
711 
712 
713 
714 
715 
716 
717 
718 
719 
720 
721 
722 
723 
724 
725 
726 
727 
728 
729 
730 


NXTBAS 


NXTBS2 


GETNUM 


NXTCHR 


TOSUB 


ZMODE 


CHRTBL 


DEX 
BPL 
LDA 
BNE 
LDA 
STA 
STA 
INX 
BEO 
BNE 


LDX 
STX 
STX 
JSR 
NOP 
EOR 
CMP 


CMP 
JMP 


LDA 
PHA 
LDA 
PHA 
LDA 
LDY 
STY 
RTS 


DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 
DFB 


NXTBIT 
MODE 
NXTBS2 
A2H,X 
AlH,X 
AB3H,X 


NXTBAS 
NXTCHR 


#$00 
A2L 
A2H 
UPMON 


#$B0 
#S0A 
DIG 
#$88 
#SFA 
LOOKASC 


#<GO 
SUBTBL,Y 


MODE 
#$00 
MODE 


SBC 
$B2 
$BE 
S9A 
SEF 
$c4 
SEC 
SA9 
$BB 
$A6 
$A4 
$06 
$95 
$07 
$02 
$05 
$FO 
$00 
SEB 
$93 
$a7 
$C6 


;LEAVE X=SFF If DIG 


3;IF MODE IS ZERO, 
3; THEN COPY A2 TO Al AND A3 


3;CLEAR A2 


;get char, upshift, INY 
3; INY now done in UPMON 


;BR IF HEX DIGIT 


3;check for ASCII input 


;DISPATCH TO SUBROUTINE, BY 

; PUSHING THE HI-ORDER SUBR ADDR, 
; THEN THE LO-ORDER SUBR ADDR 

; ONTO THE STACK, 

3 (CLEARING THE MODE, SAVE THE OLD 
3 MODE IN A-REG), 

; AND 'RTS' TO THE SUBROUTINE! 
“Cc (BASIC WARM START) 

“Y¥ (USER VECTOR) 

“E (OPEN AND DISPLAY REGISTERS) 
! (enter mini-assembler) 
(MEMORY VERIFY) 

CIN#SLOT) 

(search for 2 bytes) 
(PR#SLOT) 

(BASIC COLD START) 
(SUBTRACTION) 

(ADDITION) 

(MEMORY MOVE) 

(DELIMITER FOR MOVE, VFY) 
(SET NORMAL VIDEO) 

(SET INVERSE VIDEO) 
(DISASSEMBLE 20 INSTRS) 
(WRITE TO TAPE) 

(EXECUTE PROGRAM) 

(READ FROM TAPE) 

(MEMORY FILL) 

" (ADDRESS DELIMITER) 

CR' (END OF INPUT) 


te al 


“A 


M 
' 
N 
af 
L 
W 
G 
R 
' 








ove 


FFE2:99 
FFE3: 

FFE3: 

FFE3: 

FFE3: 

FFE3:B2 
FFE4:C9 
FFES: BE 
FFE6: FO 
FFE? :35 
FFE8:8C 
FFE9:D6 
FFEA:96 
FFEB:AF 
FFEC:17 
FFED:17 
FFEE:2B 
FFEF:1F 
FFFO :83 
FFF1:7F 
FFF2:5D 
PFF3:CC 
FFF4:B5 
FFFS:FC 
FFF6:17 
FFF7:17 
FFF8: FS 
FFF9:03 
FFFA: 

FFFA:FB 
FFFC :62 
FFFE:FA 
0000: 

0000: 

0000: 

0000: 

0000: 

0000: 

C4C8: 

Cc4c8: 

C48 :20 
C4CB:84 
C4CD:DD 
C4D0:D0 
C4D2:20 
C4D5:DD 
C4D8: FO 
C4DA:BD 
C4DD:FO 
C4DF:C9 
C4E1:FO 
C4E3:A4 
C4E5:18 
C4E6 88 


03 


c3 


13 
34 
B4 
13 
13 
BA 
oD 
BA 
07 
Aa 
03 


c4c8 


731 
732 
733 
734 
735 
736 
737 
738 
739 
740 


20 
21 


DFB $99 ;BLANK 

* 

* Table of low order monitor routine dispatch 

* addresses. High byte always $FE 

* 

SUBTBL DFB >BASCONT-1 ;*C (BASIC warm start) 
DFB >USR-1 sry (not used) 
DFB >REGZ-1 3°E (open and display registers) 
DFB >MINI-1 ;mini assembler 
DFB >VFY-I 3V (memory verify) 
DFB >INPRT-1 ;“K (IN#SLOT) 
DFB >SEARCH-1 ;search for pattern 
DFB >OUTPRT-1 ;“P (PR#SLOT) 
DFB >XBASIC-1 ;“B (BASIC cold start) 
DFB >SETMODE-1 ;'-' (subtraction) 
DFB >SETMODE-1 ;'+' (addition) 
DFB >MOVE-1 3M (memory move) 
DFB >LT-1 3'<' (delim for move,vfy) 
DFB >SETNORM-1 ;N (set normal video) 
DFB >SETINV-1 ;I1 (set inverse video) 
DFB >LIST-1 3L (disassemble 20 instrs) 
DFB WRITE-1 ;5W (write to tape) 
DFB >GO-1 36 (execute program) 
DFB >READ-1 3R (read from tape) 
DFB >SETMODE-1 ;':' (memory fill) 
DFB >SETMODE-1 ;'.' (address delimiter) 
DFB >CRMON-1 ;'CR' (end of input) 
DFB >BLANK-1 ;BLANK 


DW NMI ;NON-MASKABLE INTERRUPT VECTOR 
DW RESET ;RESET VECTOR 
DW IRQ ; INTERRUPT REQUEST VECTOR 


INCLUDE MINI 
Apple //e Mini Assembler 


Got mnemonic, check address mode 


eee 


ORG C3ORG+$1C8 


* 


AMODL JSR NNBL ;get next non-blank 
STY YSAV ;save Y 
CMP CHARI,X 
BNE AMOD2 
JSR NNBL 3get next non~blank 
CMP CHAR2,X 
BEQ AMOD3 
LDA CHAR2,X jdone yet? 
BEQ AMOD4 
CMP #SA4 3if "$" chen done 
BEQ AMOD4 
LDY YSAV jTestore Y 
AMOD2 CLC 
AMOD4 DEY 


C4E7:26 
C4E9:E0 
C4EB:DO 
C4ED:20 
C4FO:A5 
C4F2:FO 
C4F4:E8 
C4F5 :86 
C4F7:A2 
C4F9:88 
C4FA:86 
C4FC:CA 
C4FD:10 
C4FF:60 
c500: 

CF3A: 

CF3A: 

CF3A: 

CF3A: 

CF3A:E9 
CF3C:4A 
CF3D:DO 
CR3F:A4 
CF41:A6 
CF43:D0 
CF45:88 
CF46:CA 
CF47:8A 
CF48:18 
CF49:E5 
CF4B:85 
CF4D:10 
CF4F:C8 
CF50:98 
CFS1:E5 
CF53:D0 
CF55: 

CF55: 

CF55: 

CE55:A4 
CF57:B9 
CFSA:91 
CFSC:88 
CF5D:10 
CFS5F: 

CFSF: 

CFSF: 

CF5F:20 
CF62:20 
CF65:20 
CF68:4C 
CF6B: 

CF6B: 

CF6B: 


44 


oD 
A7 
3F 
OL 


35 
03 


3D 


cg 


3A 
3E 
ol 


3B 
40 


2F 
3D 
3A 


F8 


48 
1A 
1A 
E3 


C4FA 
FF 


C4F5 


c4c8 


CF3A 


CF53 


CF46 


CF50 


CFIS 


00 


CFS7 


Fo 
FC 
FC 


AMOD3 = ROL. 
CPX 
BNE 
JSR 
LDA 
BEQ 
INX 
AMODS = STX 
LDX 
DEY 
AMOD6 = STX 
DEX 
BPL 
RTS 
* 


ORG 
* 


* Calculate 
* 
REL SBC 
LSR 
BNE 
LDY 
LDX 
BNE 
DEY 
RELI DEX 
TXA 
CLC 
SBC 
STA 
BPL 
INY 
REL2 TYA 
SBC 
GOERR BNE 
* 


ASL sshift bit into format 
#$03 

AMOD6 

GETNUM 

A2H ;get high byte of address 
AMODS => 


YSAV1 
#$03 


AlH 


AMODL 


C80RG+$73A 
offset byte for relative addresses 


#$81 jeale relative address 

A 

GOERR 3bad branch 

A2H 

A2L 

RELI 
;point to offset 
jdisplacement - 1 


PCL y;subtract current PCL 
A2L sand save as displacement 
REL2 ;check page 

sget page 
PCH 3check page 


MINIERR display error 


* Move instruction to memory 


* 

MOVINST LDY 

MOV1 LDA 
STA 
DEY 
BPL 

* 


LENGTH sget instruction length 
Al1H,Y 3get a byte 
(PCL),Y  3and move it 


MOV1 


* Display instruction 


* 
JSR 
JSR 
JSR 


JMP 
* 


PRBLNK sprint blanks to make ProDOS work 
UP ;move up 2 lines 

UP 

DISLIN ;disassemble it, =>DOINST 


* Compare disassembly of all known opcodes with 
* the one typed in until a match is found 


Lye 


CF6B: 

CF6B:A5 
CF6D:20 
CF70:AA 
CF71:BD 
CF74:C5 
CF76:D0 
CF78:BD 
CF7B:C5 
CF7D:DO 
CF7F:A5 
CF81:A4 
CF83:CO 
CF85:FO 
CF87:C5 
CF89:FO 
CF8B:C6 
CF8D:DO 
CF8F:E6 
CF91:C6 
CF93: FO 
CF95: 

CF95: 

CF95: 

CF95: 

CP95:A4 
CF97:98 
CF98:AA 
CF99:4C 
CF9C: 

CF9C: 

CF9C: 

CF9C: 

CF9C: 

CF9C:20 
CF9F:AD 
CFA2:C9 
CFA4: FO 
CFA6:C9 
CFA8:DO 
CFAA:60 
CFAB: 

CFAB:20 
CFAE:C9 
CFBO:DO 
CFB2:8A 
CFB3:FO 
CFB5: 

CFB5:20 
CFB8:A9 
CFBA:85 
CFBC:20 
CFBF:0A 
CFCO:E9 


3D 
8E 


00 
42 
13 
co 
43 
oc 
44 
2E 
9D 


2E 


34 


D2 


c7 
00 


12 


8D 
01 


A7 
93 
ES 


E2 


BE 


FA 


CF8B 
Fo 


CF8B 


CF3A 
CFS5 


CF6B 


CF6B 


FC 


FF 


CFB& 


CFAB 


FF 
CF97 
CF97 


FE 


FF 


76 * 

77 GETOP LDA ALH 3get opcode 

78 JSR INSDS2 ;determine mnemonic index 

79 TAX 3X = index 

80 LDA MNEMR,X 3get right half of index 

81 CMP A4L ;does it match entry? 

82 BNE NXTOP ;=>try next opcode 

83 LDA MNEML,X 3;get left half of index 

84 CMP A4H 3does it match entry? 

85 BNE NXTOP ;™>no, try next opcode 

86 LDA ASL 3found opcode, check address mode 
87 LDY FORMAT jget addr. mode format for that opcode 
88 cPy #$9D jis it relative? 

89 BEQ REL ;™>yes, calc relative address 
90 CMP FORMAT ;does mode match? 

91 BEQ MOVINST j=>yes, move instruction to memory 
92 NXTOP DEC AIH jelse try next opcode 

93 BNE GETOP ;=>go try it 

94 INC ASL 3else try next format 

95 DEC YSAVL 

96 BEQ GETOP 3;™>go try next format 

97 * 

98 * Point to the error with a caret, beep, and fall 

99 * into the mini-assembler. 

100 * 

101 MINIERR LDY YSAV sget position 

102 ERR2 TYA 

103 TAX 

104 JMP  ERR3 j;display error, =>DOINST 

105 * 

106 * Read a line of input. If prefaced with “ ", decode 
107 * mnemonic. If "$" do monitor command. Otherwise parse 
108 * hex address before decoding mnemonic. 

109 * 

110 DOINST JSR ZMODE ;clear mode 

1il LDA $200 jget first char in line 

112 CMP #SA0 3if blank, 

113 BEQ DOLIN 3;™>go attempt disassembly 

114 CMP #S$8D sis it return? 

115 BNE GETI1 3™>no, continue 

116 RTS ;else return to Monitor 

117 * 

118 GETII JSR GETNUM sparse hexadecimal input 

119 CMP #$93 slook for "ADDR:" 

120 GOERR2 BNE ERR2 jno ":", display error 

121 TXA 3X nonzero if address entered 
122 BEQ ERR2 sno “ADDR", display error 

123 * 

124 JSR AIPCLP s;move address to PC 

125 DOLIN LDA #$03 jget starting opcode 

126 STA AIH jand save 

127 NXTCH JSR NNBL 3get next non-blank 

128 ASL A ;validate entry 

129 SBC #$BE 


CFC2:c9 
CFC4:90 
CFC6: 

CFC6: 

CFC6: 

CFC6:0A 
CFC7:0A 
CFC8:A2 
CFCA:0A 
CFCB:26 
CFCD:26 
CFCF:CA 
CFDO:10 
CFD2:C6 
CFD4: FO 
CFD6:10 
CFD8:A2 
CFDA:20 
CFDD:A5 
CFDF:0A 
CFEO:0A 
CFE1:05 
CFE3:C9 
CFES : BO 
CFE7 : A6 
CFE9:FO 
CFEB:09 
CFED:85 
CFEF:84 
CFFL:B9 
CFF4:C9 
CFF6:FO 
CFF8:C9 
CFFA:DO 
CFFC:4C 
CFFF: 

CFFF:00 


c2 
DL 


04 


42 
43 


F8 
3n 
F4 
E4 
05 


CF97 


CFCA 


CFCA 
CFBC 


c8 C4 


44 


CFED 


CFED 


130 
131 
132 


* 


CMP 
BCC 


#$C2 
ERR2 


3™=>flag bad mnemonic 


133 * Form mnemonic for later comparison 


134 
135 
136 
137 


138 NXTMN 


139 
140 
141 
142 
143 
144 
145 
146 
147 
148 
149 
150 
151 
152 
153 
154 
155 
156 
157 
158 
159 
160 
161 
162 
163 
164 
165 
166 


* 


AMOD7 


AMOD8 
* 


ASL 
ASL 
LDX 
ASL 
ROL 
ROL 
DEX 
BPL 
DEC 
BEQ 
BPL 
LDX 
JSR 
LDA 
ASL 
ASL 
ORA 
CMP 
BCS 
LDX 

BEQ 
ORA 
STA 
STY 

LDA 
CMP 

BEQ 
CMP 

BNE 

JMP 


DFB 


A 

A 
#804 
A 
AGL 
ASH 


NXTMN 
Al 


;decrement mnemonic count 


jindex into address mode tables 
3do this elsewhere 
3get format 


jget our format 


j;update format 

;update position 

3Bet next character 
gia: te @. "3"7 

3;=>yes, skip comment 
jis it carriage return 


get next opcode 


sbyte for making CTOD checksum ok 


wos:auyuQzajddy mmm uo.f pappojumoqg 


Glossary 


accumulator: The register in the 65C02 
microprocessor where most computations are 
performed. 


ACIA: Acronym for Asynchronous 
Communications Interface Adapter. A single chip 
that converts data from parallel to serial form and 
vice versa. An ACIA handles serial transmission 
and reception and RS-232-C signals under the 
control of its internal registers, which can be set 
and changed by firmware or software. 


acronym: A word formed from the initial letters 
of a name or phrase, such as ROM (from read- 
only memory). 


address: A number that specifies the location of 
a single byte of memory. Addresses can be given 
as decimal integers or as hexadecimal integers. A 
64K system has addresses ranging from 0 to 65535 
Cin decimal) or from $0000 to $FFFF (in 
hexadecimal). 


algorithm: A step-by-step procedure for solving 
a problem or accomplishing a task. 


American Simplified Keyboard: See Dvorak 
keyboard. 


analog: Varying smoothly and continuously over 
a range, rather than changing in discrete jumps. 
For example, a conventional 12-hour clock face is 
an analog device that shows the time of day by the 
continuously changing position of the clock’s 
hands. Compare digital. 


analog data: Data in the form of continuously 
variable quantities. Compare digital data. 


analog signal: A signal that varies continuously 
over time, rather than being sent and received in 
discrete intervals. Compare digital signal. 


analog-to-digital converter (ADC): A device 
that converts quantities from analog to digital 
form. For example, computer hand controls 
convert the position of the control dial (an analog 
quantity) into a discrete number (a digital 
quantity) that changes stepwise even when the dial 
is turned smoothly. 


AND: A logical operator that produces a true 
result if both its operands are true, and a false 
result if either or both of its operands are false. 
Compare OR, NOT, exclusive OR. 


ANSI: Acronym for American National 
Standards Institute, which sets standards for many 
technical fields and is the most common standard 
for computer terminals. 


Apple I: The first Apple computer. It was built in 
a garage in California by Steve Jobs and Steve 
Wozniak. 


Applesoft BASIC: The Apple II dialect of the 
BASIC programming language. An interpreter for 
creating and executing Applesoft BASIC programs 
is built into the firmware of computers in the 
Apple II family. See also BASIC, Integer 
BASIC. 


Apple II: An Apple computer, part of the 
Apple II family. The Apple III offered a built-in 
disk drive and built-in RS-232-C (serial) port. Its 
memory was expandable to 256K. 
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Apple I: A family of computers, including the 
original Apple II, the Apple II Plus, the Apple Ile, 
the Apple IIc, and the Apple IIGS. The original 
Apple II used Integer BASIC instead of Applesoft 
BASIC, and it required a keyboard command 
(PR#6) in order to start up from a disk. 


Apple Ic: A transportable personal computer in 
the Apple II family, with a disk drive and 80- 
column display capability built in. 


Apple Ie: A personal computer in the Apple II 
family with seven expansion slots and an auxiliary 
memory slot that allow the user to enhance the 
computer’s capabilities with peripheral and 
auxiliary cards. The Apple Ile has been improved 
and enhanced over the years. 


Apple Me 80-Column Text Card: A peripheral 
card that plugs into the Apple Ile’s auxiliary 
memory slot and allows the computer to display 
either 40 or 80 characters per line. 


Apple He Extended 80-Column Text Card: A 
peripheral card that plugs into the Apple Ile’s 
auxiliary memory slot and allows the computer to 
display either 40 or 80 characters per line while 
extending the computer’s memory capacity by 
64K. 


Apple Gs: A powerful new member of the 
Apple II family. The Apple IIGs uses a 16-bit 
microprocessor and has 256K of RAM. It has slots 
like the Apple Ile and ports like the Apple IIc, and 
contains a 15-voice custom sound chip. 


Apple I Pascal: A software system for the 
Apple II family that lets you create and execute 
programs written in the Pascal programming 
language. Apple II Pascal was adapted by Apple 
Computer from the University of California, San 
Diego, Pascal Operating System (UCSD Pascal). 


Apple 0 Plus: A personal computer in the 
Apple II family with expansion slots that allow the 
user to enhance the computer’s capabilities with 
peripheral and auxiliary cards. 
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application program: A program written for 
some specific purpose, such as word processing 
data base management, graphics, or 
telecommunication. Compare system 
program. 


argument: A value on which a function or 
statement operates; it can be a number or a 
variable. For example, in the BASIC statement 
VTAB 10, the number 10 is the argument. 
Compare operand. 


arithmetic expression: A combination of 
numbers and arithmetic operators (such as 3 + 5) 
that indicates some operation to be carried out. 


arithmetic operator: An operator, such as +, 
that combines numeric values to produce a 
numeric result. Compare logical operator, 
relational operator. 


ASCII: Acronym for American Standard Code 
for Information Interchange; pronounced 
“ASK-ee.” A code in which the numbers from 0 to 
127 stand for text characters. ASCII code is used 
for representing text inside a computer and for 
transmitting text between computers or between a 
computer and a peripheral device. Compare 
EBCDIC., 


assembler: A language translator that converts a 
program written in assembly language into an 
equivalent program in machine language. The 
opposite of a disassembler. 


assembly language: A low-level programming 
language in which individual machine-language 
instructions are written in a symbolic form that’s 
easier to understand than machine language itself. 
Each assembly-language instruction produces one 
machine-language instruction. See also machine 
language. 


asynchronous: Not synchronized by a mutual 
timing signal or clock. Compare synchronous. 


asynchronous transmission: A method of 
data transmission in which the receiving and 
sending devices don’t share a common timer, and 
no timing data is transmitted. Each information 
character is individually synchronized, usually by 
the use of start and stop bits. The time interval 
between characters isn’t necessarily fixed. 
Compare synchronous transmission. 


auxiliary slot: The special expansion slot inside 
the Apple Ie used for the Apple Ie 80-Column 
Text Card or Extended 80-Column Text Card, and 
also for the RGB monitor card. The slot is labeled 
“AUX. CONNECTOR” on the circuit board. 


base address: In indexed addressing, the fixed 
component of an address. 


BASIC: Acronym for Beginners All-purpose 
Symbolic Instruction Code. BASIC is a high-level 
programming language designed to be easy to 
learn. Two versions of BASIC are available from 
Apple Computer for use with all Apple II-family 
systems: Applesoft BASIC (built into the 
firmware) and Integer BASIC. 


baud: A unit of data transmission speed: the 
number of discrete signal state changes per 
second. Often, but not always, equivalent to bits 
per second. Compare bit rate. 


binary: Characterized by having two different 
components, or by having only two alternatives or 
values available; sometimes used synonymously 
with binary system. 


binary digit: The smallest unit of information in 
the binary number system; a 0 or a 1. Also called a 
bit. 


binary operator: An operator that combines two 
operands to produce a result. For example, + is a 
binary arithmetic operator; < is a binary 
relational operator; OR is a binary logical 
operator. Compare unary operator. 


binary system: The representation of numbers 
in the base-2 system, using only the two digits 0 
and 1. For example, the numbers 0, 1, 2, 3, and 4 
become 0, 1, 10, 11, and 100 in binary notation. 
The binary system is commonly used in computers 
because the values 0 and 1 can easily be 
represented in a variety of ways, such as the 
presence or absence of current, positive or 
negative voltage, or a white or black dot on the 
display screen. A single binary digit—a 0 or a 1—is 
called a bit. Compare decimal, hexadecimal. 


bit: A contraction of binary digit. The smallest 
unit of information that a computer can hold. The 
value of a bit (1 or 0) represents a simple two-way 
choice, such as yes or no, on or off, positive or 
negative, something or nothing. See also binary 
system. 


bit rate: The speed at which bits are transmitted, 
usually expressed as bits per second, or bps. 
Compare baud. 


bits per second: See bit rate. 
board: See printed-circuit board. 


body: In BASIC, the statements or instructions 
that make up a part of a program, such as a loop or 
a subroutine. 


boot: Another way to say start up. A computer 
boots by loading a program into memory from an 
external storage medium such as a disk. Starting up 
is often accomplished by first loading a small 
program, which then reads a larger program into 
memory. The program is said to “pull itself up by 
its own bootstraps”—hence the term 
bootstrapping or booting. 


boot disk: See startup disk. 
bootstrap: See boot. 
bps: See bit rate. 


branch: (v) To pass program control to a line or 
statement other than the next in sequence. (n) A 
statement that performs a branch. See 
conditional branch, unconditional branch. 
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BREAK: A SPACE (0) signal, sent over a 
communication line, of long enough duration to 
interrupt the sender. This signal is often used to 
end a session with a time-sharing service. BREAK 
is also used in BASIC to stop execution of a 
program. It’s generated by pressing Control-C. 


BRK: A “software interrupt.” An instruction that 
causes the 6502 or 65C02 microprocessor to halt. 
Pronounced “break.” 


buffer: A “holding area” of the computer's 
memory where information can be stored by one 
program or device and then read at a different rate 
by another; for example, a print buffer. In editing 
functions, an area in memory where deleted (cut) 
or copied data is held. In some applications, this 
area is called the Clipboard. 


bug: An error in a program that causes it not to 
work as intended. The expression reportedly 
comes from the early days of computing when an 
itinerant moth shorted a connection and caused a 
breakdown in a room-size computer. 


bus: A group of wires or circuits that transmit 
related information from one part of a computer 
system to another. In a network, a line of cable 
with connectors linking devices together. A bus 
network has a beginning and an end. (It’s not ina 
closed circle or T shape.) 


byte: A unit of information consisting of a fixed 
number of bits. On Apple II systems, one byte 
consists of a series of eight bits, and a byte can 
represent any value between 0 and 255. The 
sequence represents an instruction, letter, 
number, punctuation mark, or other character. 
See also kilobyte, megabyte. 


cable: An insulated bundle of wires with 
connectors on the ends; the number of wires 
varies with the type of connection. Examples are 
serial cables, disk drive cables, and AppleTalk 
cables. 
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call: (v) To request the execution of a subroutine, 
function, or procedure. (n) A request from the 
keyboard or from a procedure to execute a named 
procedure. See procedure. 


carriage return: An ASCII character (decimal 
13) that ordinarily causes a printer or display 
device to place the next character on the left 
margin. 


carrier: The background signal on a 
communication channel that is modified to carry 
information. Under RS-232-C rules, the carrier 
signal is equivalent to a continuous MARK (1) 
signal; a transition to 0 then represents a start bit. 


carry flag: A status bit in the 6502 or 65C02 
microprocessor, used as a ninth bit with the eight 
accumulator bits in addition, subtraction, 
rotation, and shift operations. 


central processing unit (CPU): The “brain” of 
the computer; the microprocessor that performs 

the actual computations in machine language. See 
microprocessor. 


character: Any symbol that has a widely 
understood meaning and thus can convey 
information. Some characters—such as letters, 
numbers, and punctuation—can be displayed on 
the monitor screen and printed on a printer. 
Compare control character. 


character code: A number used to represent a 
character for processing by a computer system. 


character set: The entire set of characters that 
can be either shown on a monitor or used to code 
computer instructions. In a printer, the entire set 
of characters that the printer is capable of 
printing. 


Clear To Send: An RS-232-C signal from a DCE 
to a DTE that is normally kept false until the DCE 
makes it true, indicating that all circuits are ready 
to transfer data out. See Data Communication 

Equipment, Data Terminal Equipment. 


code: (1) A number or symbol used to represent 
some piece of information. (2) The statements or 
instructions that make up a program. 


cold start: The process of starting up the Apple II 
- when the power is first turned on (or as if the power 
had just been turned on) by loading the operating 
system into main memory, and then loading and 

running a program. Compare warm start. 


column: A vertical arrangement of graphics 
points or character positions on the display. 


command: An instruction that causes the 
computer to perform some action. A command 
can be typed from a keyboard, selected from a 
menu with a hand-held device (such as a mouse), 
or embedded in a program. 


compiler: A language translator that converts a 
program written in a high-level programming 
language (source code) into an equivalent 
program in some lower-level language such as 
machine language (object code) for later 
execution. Compare interpreter. 


composite video: A video signal that includes 
both display information and the synchronization 
(and other) signals needed to display it. See RGB 
monitor. 


computer: An electronic device that performs 
predefined (programmed) computations at high 
speed and with great accuracy. A machine that is 
used to store, transfer, and transform 
information. 


computer language: See programming 
language. 


conditional branch: A branch whose execution 
depends on the truth of a condition or the value of 
an expression. Compare unconditional branch. 


configuration: (1) The total combination of 
hardware components—CPU, video display 
device, keyboard, and peripheral devices—that 
make up a computer system. (2) The software 
settings that allow various hardware components 
of a computer system to communicate with each 
other. 


connector: A plug, socket, jack, or port. 


constant: In a program, a symbol that represents 
a fixed, unchanging value. Compare variable. 


control character: A nonprinting character that 
controls or modifies the way information is 
printed or displayed. In the Apple II family, 
control characters have ASCII values between 0 
and 31, and are typed from a keyboard by holding 
down the Control key while pressing some other 
key. In the Macintosh family, the Command key 
performs a similar function. 


control code: One or more nonprinting 
characters—included in a text file—whose 
function is to change the way a printer prints the 
text. For example, a program may use certain 
control codes to turn boldface printing on and off. 
See control character. 


control key: A general term for a key that 
controls the operation of other keys; for example, 
Apple, Caps Lock, Control, Option, and Shift. 
When you hold down or engage a control key while 
pressing another key, the combination makes that 
other key behave differently. Also called a 
modifier key. 


Control key: A specific key on Apple II-family 
keyboards that produces control characters 
when used in combination with other keys. 


controller card: A peripheral card that connects 
a device such as a printer or disk drive to a 
computer’s main logic board and controls the 
operation of the device. 
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Control-Reset: A combination keystroke on 
Apple II-family computers that usually causes an 
Applesoft BASIC program or command to stop 
immediately. If a program disables the Control- 
Reset feature, you need to turn the computer off to 
get the program to stop. 


copy protect: To make a disk uncopyable. 
Software publishers frequently try to copy protect 
their disks to prevent them from being illegally 
duplicated by software pirates. Compare write 
protect. 


CPU: See central processing unit. 


crash: To cease to operate unexpectedly, 
possibly destroying information in the process. 


current input device: The source, such as the 
keyboard or a modem, from which a program is 
currently receiving its input. 


current output device: The destination, such as 
the display screen or a printer, currently receiving 
a program’s output. 


cursor: A symbol displayed on the screen 
marking where the user’s next action will take effect 
or where the next character typed from the 
keyboard will appear. 


DAC: See digital-to-analog converter. 


data: Information, especially information used 
or operated on by a program. The smallest unit of 
information a computer can understand is a bit. 


data bits: The bits in a communication transfer 
that contain information. Compare start bit, 
stop bit. 


Data Carrier Detect (DCD): An RS-232-C signal 
from a DCE (such as a modem) to a DTE (such as 
an Apple Ile) indicating that a communication 
connection has been established. See Data 
Communication Equipment, Data Terminal 
Equipment. 
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Data Communication Equipment (DCE): As 
defined by the RS-232-C standard, any device that 
transmits or receives information. Usually this 
device is a modem. 


data set: A device that modulates, demodulates, 
and controls signals transferred between business 
machines and communication facilities. A form of 
modem. 


Data Set Ready (DSR): An RS-232-C signal from 
a DCE to a DTE indicating that the DCE has 
established a connection. See Data 
Communication Equipment, Data Terminal 
Equipment. 


Data Terminal Equipment (DTE): As defined 
by the RS-232-C standard, any device that 
generates or absorbs information, thus acting as 
an endpoint of a communication connection. A 
computer might serve as a DTE. 


Data Terminal Ready (DTR): An RS-232-C 
signal from a DTE to a DCE indicating a readiness 
to transmit or receive data. See Data 
Communication Equipment, Data Terminal 
Equipment. 


DCD: See Data Carrier Detect. 
DCE: See Data Communication Equipment. 


debug: A colloquial term that means to locate 
and correct an error or the cause of a problem or 
malfunction in a computer program. Compare 
troubleshoot. See also bug. 


decimal: The common form of number 
representation used in everyday life, in which 
numbers are expressed in in the base-10 system, 
using the ten digits 0 through 9. Compare binary, 
hexadecimal. 


default: A preset response to a question or 
prompt. The default is automatically used by the 
computer if you don’t supply a different response. 
Default values prevent a program from stalling or 
crashing if no value is supplied by the user. 


deferred execution: The execution of a BASIC 
program instruction that is part of a complete 
program. The program instruction is executed 
only when the complete program is run. You defer 
execution of the instruction by preceding it with a 
program line number. The complete program 
executes consecutive instructions in numerical 
order. Compare immediate execution. 


Delete key: A key on the upper-right corner of 
the Apple Ile and IIc keyboards that erases the 
character immediately preceding (to the left of) 
the cursor. Similar to the Macintosh Backspace 
key. 


delimiter: A character that is used for 
punctuation to mark the beginning or end of a 
sequence of characters, and which therefore is not 
considered part of the sequence itself. For 
example, Applesoft BASIC uses the double 
quotation mark ("") as a delimiter for string 
constants: the string "DOG" consists of the three 
characters D, O, and G, and does not include the 
quotation marks. 


demodulate: To recover the information being 
transmitted by a modulated signal. For example, a 
conventional radio receiver demodulates an 
incoming broadcast signal to convert it into the 
sound emitted by the radio’s speaker. Compare 
modulate. 


device: Frequently used as a short form of 
peripheral device. 


device driver: A program that manages the 
transfer of information between the computer and 
a peripheral device. 


device handler: See device driver. 


digit: (1) One of the characters 0 through 9, used 
to express numbers in decimal form. (2) One of 
the characters used to express numbers in some 
other form, such as 0 and 1 in binary or 0 through 
9 and A through F in hexadecimal. 


digital: Represented in a discrete 
(noncontinuous) form, such as numerical digits or 
integers. For example, contemporary digital 
clocks show the time as a digital display (such as 
2:57) instead of using the positions of a pair of 
hands on a clock face. Compare analog. 


digital data: Data that can be represented by 
digits—that is, data that are discrete rather than 
continuously variable. Compare analog data. 


digital signal: A signal that is sent and received 
in discrete intervals. A signal that does not vary 
continuously over time. Compare analog signal. 


digital-to-analog converter: A device that 
converts quantities from digital to analog form. 


DIP: See dual in-line package. 


DIP switches: A bank of tiny switches, each of 
which can be moved manually one way or the 
other to represent one of two values (usually on 
and off). See dual in-line package. 


disassembler: A language translator that 
converts a machine-language program into an 
equivalent program in assembly language, which 
is easier for programmers to understand. The 
opposite of an assembler. 


disk: An information-storage medium consisting 
of a flat, circular, magnetic surface on which 
information can be recorded in the form of small 
magnetized spots, in a manner similar to the way 
sounds are recorded on tape. See floppy disk, 
hard disk. 


disk-based: See disk-resident. 


disk controller card: A peripheral card that 
provides the connection between one or two disk 
drives and the computer. This connection, or 
interface, is built into both the Apple IIc and 
Macintosh-family computers. 


disk drive: The device that holds a disk, retrieves 
information from it, and saves information to it. 
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disk envelope: A removable, protective paper 
sleeve used when handling or storing a 5.25-inch 
disk. It must be removed before you insert the disk 
in a disk drive. Compare disk jacket. 


disk jacket: A permanent, protective covering 
for a disk. 5.25-inch disks have flexible, paper or 
plastic jackets; 3.5-inch disks have hard plastic 
jackets. The disk is never removed from the jacket. 
Compare disk envelope. 


Disk Operating System (DOS): An optional 
software system for the Apple II family of 
computers that enables the computer to control 
and communicate with one or more disk drives. 
The acronym DOS rhymes with boss. 


disk-resident: An adjective describing a 
program that does not remain in memory. The 
computer retrieves all or part of the program from 
the disk, as needed. Sometimes called disk-based. 
Compare memory-resident. 


Disk II drive: An older type of disk drive made 
and sold by Apple Computer for use with the 
Apple IJ, II Plus, and Ile. It uses 5.25-inch disks. 


display: (1) A general term to describe what you 
see on the screen of your display device when 
you’re using a computer, from the verb form, 
which means “to place into view.” (2) Short for a 
display device. 


display color: The color currently being used to 
draw high-resolution or low-resolution graphics 
on the display screen. 


display device: A device that displays 
information, such as a television set or video 
monitor. 


display screen: The screen of the monitor, the 
area where you view text and pictures when using 
the computer. 


DOS 3.2: An early Apple II operating system. 
DOS stands for Disk Operating System; 3.2 is 
the version number. Disks formatted using DOS 
3.2 have 13 sectors per track. 
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DOS 3.3: An operating system used by the 

Apple II family of computers. DOS stands for Disk 
Operating System; 3.3 is the version number. 
Disks formatted with DOS 3.3 have 16 sectors per 
track. 


drive: See disk drive. 
DSR: 
DTE: See Data Terminal Equipment. 
DTR: See Data Terminal Ready. 


dual in-line package (DIP): An integrated 
circuit packaged in a narrow rectangular box with a 
row of metal pins along each side. DIP switches 
on the box allow you to change settings. For 
example, ImageWriter printer DIP switches 
control functions such as line feed, form 
length, and baud setting. 


Dvorak keyboard: An alternate keyboard layout, 
also known as the American Simplified Keyboard, 
which increases typing speed because the keys 
most often used are in the positions easiest to 
reach. Compare QWERTY keyboard. 


EBCDIC: Acronym for Extended Binary-Coded 
Decimal Interchange Code; pronounced 
“EB-si-dik.” A code used by IBM that represents 
each letter, number, special character, and 
control character as an 8-bit binary number. 
EBCDIC has a character set of 256 8-bit 
characters. Compare ASCII. 


See Data Set Ready. 


effective address: In machine-language 
programming, the address of the memory 
location on which a particular instruction 
operates, which may be arrived at by indexed 
addressing or some other addressing method. 


80-column text card: A peripheral card that 
allows the Apple II, Apple II Plus, and Apple Ile to 
display text in either 40 columns or 80 columns. 


80/40-column switch: A switch that controls 
the maximum number of columns or characters 
across the screen. A television can legibly display 
a maximum of 40 characters across the screen, 
whereas a video monitor can display 80 
‘characters. 


embedded: Contained within. For example, the 
string "HUMPTY DUMPTY' is said to contain an 
embedded space. 


emulate: To operate in a way identical to a 
different system. For example, the Apple II 
2780/3780 Protocol Emulator and the Apple II 
3270 BSC Protocol Emulator, together with the 
Apple Communications Protocol Card (ACPC), 
allow the Apple II, Apple II Plus, or Apple Ile to 
emulate the operations of IBM 3278 and 3277 
terminals and 3274 and 3271 control units. 


end-of-command mark: A punctuation mark 
used to separate commands sent to a peripheral 
device such as a printer or plotter. Also called a 
command terminator. 


end-of-line character: A character that 
indicates that the preceding text constitutes a full 
line. 


error code: A number or other symbol 
representing a type of error. 


error message: A message displayed or printed 
to tell you of an error or problem in the execution 
of a program or in your communication with the 
system. An error message is often accompanied 
by a beep. 


ESCAPE character: An ASCII character that, 
with many programs and devices, allows you to 
perform special functions when used in 
combination keypresses. 


escape code: A sequence of characters that 
begins with an ESCAPE character and constitutes a 
complete command. Usually synonymous with 
escape sequence. 


Escape key: A key on Apple IJ-family computers 
that generates the ESCAPE character. The Escape 
key is labeled Esc. In many applications, pressing 
Escape allows you to return to a previous menu or 
to stop a procedure. 


escape mode: A state of the Apple Ile and IIc 
entered by pressing the Escape key and certain 
other keys. The other keys take on special 
meanings for positioning the cursor and 
controlling the display of text on the screen. 


escape sequence: A sequence of keystrokes, 
beginning with the Escape key. In escape mode, 
escape sequences are used for positioning the 
cursor and controlling the display of text on the 
screen. Escape sequences are also used as codes to 
control printers. 


Esc key: See Escape key. 


even/odd parity check: In data transmission, a 
check that tests whether the number of 1 bits in a 
group of binary digits is even (even parity check) 
or odd (odd parity check). 


even parity: In data transmission, the use of an 
extra bit set to 0 or 1 as necessary to make the total 
number of 1 bits an even number; used as a means 
of error checking. Compare MARK parity, odd 
parity. 


exclusive OR: A logical operator that produces a 
true result if one of its operands is true and the 
other false, and a false result if its operands are 
both true or both false. Compare OR, AND, and 
NOT. 


execute: To perform the actions specified by a 
program command or sequence of commands. 


expansion slot: A connector into which you can 
install a peripheral card. Sometimes called a 
peripheral slot. See also auxiliary slot. 


expression: A formula in a program that defines 
a calculation to be performed. 


FIFO: Acronym for “first in, first out” order, as 
in a queue. 
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file: Any named, ordered collection of 
information stored on a disk. Application 
programs and operating systems on disks are files. 
You make a file when you create text or graphics, 
give the material a name, and save it to disk. 


firmware: Programs stored permanently in 
read-only memory (ROM). Such programs (for 
example, the Applesoft Interpreter and the 
Monitor program) are built into the computer at 
the factory. They can be executed at any time but 
cannot be modified or erased from main 
memory. Compare hardware, software. 


fixed-point: A method of representing numbers 
inside the computer in which the decimal point 
(more correctly, the binary point) is considered 
to occur at a fixed position within the number. 
Typically, the point is considered to lie at the right 
end of the number so that the number is 
interpreted as an integer. Compare floating- 
point. 


flag: A variable whose value (usually 1 or 0, 
standing for true or false) indicates whether some 
condition holds or whether some event has 
occurred. A flag is used to control the program’s 
actions at some later time. 


floating-point: A method of representing 
numbers inside the computer in which the decimal 
point (more correctly, the binary point) is 
permitted to “float” to different positions within 
the number. Some of the bits within the number 
itself are used to keep track of the point’s position. 
Compare fixed-point. 


floppy disk: A disk made of flexible plastic, as 
compared to a hard disk, which is made of metal. 
The term floppy is now usually applied only to 
disks with thin, flexible disk jackets, such as 5.25- 
inch disks. With 3.5-inch disks, the disk itself is 
flexible, but the jacket is made of hard plastic; 
thus, 3.5-inch disks aren’t particularly “floppy.” 
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format: (n) (1) The form in which information is 
organized or presented. (2) The general shape 
and appearance of a printed page, including page 
size, character width and spacing, line spacing, 
and so on. (v) To divide a disk into tracks and 
sectors where information can be stored. Blank 
disks must be formatted before you can save 
information on them for the first time; same as 
initialize. 


form feed: An ASCII character (decimal 12) that 
causes a printer or other paper-handling device to 
advance to the top of the next page. 


Fortran: Short for Formula Translator. A high- 
level programming language especially suitable 
for applications requiring extensive numerical 
calculations, such as in mathematics, 
engineering, and the sciences. 


framing error: In serial data transfer, the 
absence of the expected stop bit(s) at the end of a 
received character. 


frequency: In alternating current (AC) signals, 
the number of complete cycles transmitted per 
second, Frequency is usually expressed in hertz 
(cycles per second), kilohertz (kilocycles per 
second), or megahertz (megacycles per second). 
In acoustics, frequency of vibration determines 
musical pitch. 


full duplex: A four-wire communication circuit 
or protocol that allows two-way data transmission 
between two points at the same time. Compare 
half duplex. 


function: A preprogrammed calculation that can 
be carried out on request from any point in a 
program. A function takes in one or more 
arguments and returns a single value. It can 
therefore be embedded in an expression. 


game I/O connector: A 16-pin connector 
inside the Apple II, II Plus, and Ile, originally 
designed for connecting hand controls to the 
computer, but also used for connecting some 
other peripheral devices. Compare hand control 
connector. 


graph: A pictorial representation of data. 


graphics: (1) Information presented in the form 
of pictures or images. (2) The display of pictures 
or images on a computer’s display screen. 
Compare text. 


half duplex: A two-wire communication circuit 
or protocol designed for data transmission in 
either direction but not both directions 
simultaneously. Compare full duplex. 


hand control connector: A 9-pin connector on 
the back panel of the Apple Ile and IIc computers, 
used for connecting hand controls to the 
computer. Compare game I/O connector. 


hand controls: Peripheral devices, with rotating 
dials and push buttons. Hand controls are used to 
control game-playing programs, but they can also 
be used in other applications. 


hang: To cease operation because either an 
expected condition is not satisfied or an infinite 
loop is occurring. A computer that’s hanging is 
called a hung system. Compare crash. 


hard disk: A disk made of metal and sealed into a 
drive or cartridge. A hard disk can store very large 
amounts of information compared to a floppy 
disk. 


hard disk drive: A device that holds a hard disk, 
retrieves information from it, and saves 
information to it. Hard disks made for 
microprocessors are permanently sealed into the 
drives. 


hardware: In computer terminology, the 
machinery that makes up a computer system. 
Compare firmware, software. 


hertz: The unit of frequency of vibration or 
oscillation, defined as the number of cycles per 
second. Named for the physicist Heinrich Hertz 
and abbreviated Hz. The 6502 microprocessor 
used in the Apple II systems operates at a clock 
frequency of about 1 million hertz, or 1 megahertz 
(MHz). The 68000 microprocessor used in the 
Macintosh operates at 7.8336 MHz. 


hexadecimal: The representation of numbers in 
the base-16 system, using the ten digits 0 through 9 
and the six letters A through F. For example, the 
decimal numbers 0, 1, 2, 3, 4, ... 8, 9, 10, 11, ... 
15, 16, 17 would be shown in hexadecimal 
notation as 00, 01, 02, 03, 04, ... 08, 09, OA, OB, 
... OF, 10, 11. Hexadecimal numbers are easier for 
people to read and understand than are binary 
numbers, and they can be converted easily and 
directly to binary form. Each hexadecimal digit 
corresponds to a sequence of four binary digits, 
or bits. Hexadecimal numbers are usually 
preceded by a dollar sign ($). 


high ASCII characters: ASCII characters with 
decimal values of 128 to 255. Called high ASCII 
because their high bit (first binary digit) is set to 1 
(for on) rather than 0 (for off). 


high-level language: A programming language 
that is relatively easy for people to understand. A 
single statement in a high-level language typically 
corresponds to several instructions of machine 
language. High-level languages available from 
Apple Computer include BASIC, Pascal, Instant 
Pascal, Logo, Pilot, SuperPILOT, and Fortran. 
Compare low-level language. 


high-order byte: The more significant half of a 
memory address or other two-byte quantity. In the 
6502 microprocessor used in the Apple II family of 
computers, the low-order byte of an address is 
usually stored first, and the high-order byte 
second. In the 68000 microprocessors used in the 
Macintosh family, the high-order byte is stored 
first. 


high-resolution graphics: The display of 
graphics on a screen as a six-color array of points, 
280 columns wide and 192 rows high. When a text 
window is in use, the visible high-resolution 
graphics display is 280 by 160 points. 


hold time: In computer circuits, the amount of 
time a signal must remain valid after some related 
signal has been turned off. Compare setup time. 


Hz: See hertz. 
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IC: See integrated circuit. 


immediate execution: The execution of a 
program statement as soon as it is typed. In 
BASIC, immediate execution occurs when the line 
is typed without a line number; immediate 
execution allows you to try out nearly every 
statement immediately to see how it works. 
Compare deferred execution. 


implement: To put into practical effect, as to 
implement a plan. For example, a language 
translator implements a particular language. 


IN#: This command designates the source of 
subsequent input characters. It can be used to 
designate a device in a slot or a machine-language 
routine as the source of input. 


index: (1) A number used to identify a member 
of a list or table by its sequential position. (2) A list 
or table whose entries are identified by sequential 
position. 3) In machine-language programming, 
the variable component of an indexed address, 
contained in an index register and added to the 
base address to form the effective address. 


indexed addressing: A method used in 
machine-language programming to specify 
memory addresses. See also memory location. 


index register: A register in a computer 
processor that holds an index for use in indexed 
addressing. The 6502 microprocessor used in the 
Apple II family of computers has two index 
registers, called the X register and the Y 
register. The 68000 microprocessor used in 
Macintosh-family computers has 16 registers that 
can be used as index registers. 


index variable: A variable whose value changes 
on each pass through a loop. Often called control 
variable or loop variable. 


infinite loop: A section of a program that will 
repeat the same sequence of actions indefinitely. 
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initialize: (1) To set to an initial state or value in 
preparation for some computation. (2) To 
prepare a blank disk to receive information by 
organizing its surface into tracks and sectors; same 
as format. 


initialized disk: A disk that has been organized 
into tracks and sectors by the computer and is 
therefore ready to store information. 


input: Information transferred into a computer 
from some external source, such as the keyboard, 
a disk drive, or a modem. 


input/output (I/O): The process by which 
information is transferred between the computer’s 
memory and its keyboard or peripheral devices. 


input routine: A machine-language routine; the 
standard input routine reads characters from the 
keyboard. A different input routine might, for 
example, read them from an external terminal. 


instruction: A unit of a machine-language or 
assembly-language program corresponding to a 
single action for the computer’s processor to 
perform. 


integer: A whole number in fixed-point form. 
Compare real number. 


Integer BASIC: A version of the BASIC 
programming language used by the Apple II family 
of computers. Integer BASIC is older than 
Applesoft BASIC and is capable of processing 
numbers in integer (fixed-point) form only. Many 
games are written in Integer BASIC because its 
instructions can be executed very quickly. 
Compare Applesoft BASIC. 


integrated circuit: An electronic 
circuit—including components and 
interconnections—entirely contained in a single 
piece of semiconducting material, usually silicon. 
Often referred to as an IC or a chip. 


interface: (1) The point at which independent 
systems or diverse groups interact. The devices, 
rules, or conventions by which one component of 
a system communicates with another. Also, the 
point of communication between a person and a 

‘computer. (2) The part of a program that defines 
constants, variables, and data structures, rather 
than procedures. 


interface card: A peripheral card that 
implements a particular interface (such as a 
parallel or serial interface) by which the computer 
can communicate with a peripheral device such as 
a printer or modem. 


interpreter: A language translator that reads a 
program instruction by instruction and 
immediately translates each instruction for the 
computer to carry out. Compare compiler. 


interrupt: A temporary suspension in the 
execution of a program that allows the computer to 
perform some other task, typically in response to a 
signal from a peripheral device or other source 
external to the computer. 


inverse video: The display of text on the 
computer’s display screen in the form of dark dots 
on a light (or other single phosphor color) 
background, instead of the usual light dots on a 
dark background. 


I/O: See input/output. 


I/O device: Input/output device. A device that 
transfers information into or out of a computer. 
See input, output, peripheral device. 


I/O link: A fixed location that contains the 
address of an input/output subroutine in the 
computer’s Monitor program. 


IWM: “Integrated Woz Machine”; the custom 
chip that controls Apple’s 3.5-inch disk drives. 


joystick: A peripheral device with a lever, 
typically used to move creatures and objects in 
game programs; a joystick can also used in 
applications such as computer-aided design and 
graphics programs. 


K: See kilobyte. 


keyboard: The set of keys, similar to a typewriter 
keyboard, used for entering information into the 
computer. 


keyboard input connector: The connector 
inside the Apple II family of computers by which 
the keyboard is connected to the computer. 


keyword: A special word or sequence of 
characters that identifies a particular type of 
statement or command, such as RUN, BRUN, or 
PRINT. 


kilobyte (K): A unit of measurement consisting 
of 1024 (2!) bytes. In this usage, kilo (from the 
Greek, meaning a thousand) stands for 1024. Thus, 
64K memory equals 65,536 bytes. See also 
megabyte. 


KSW: The symbolic name of the location in the 
computer’s memory where the standard input link 
(namely, to the keyboard) is stored. KSW stands 
for keyboard switch. 


language: See programming language. 


language card: A peripheral card that, when ° 
placed in slot 0 of a 48K Apple II or Apple II Plus, 
gives the computer a total of 64K of memory. If 
you have an Apple II or Apple II Plus, you need a 
language card or the equivalent to use ProDOS. 


language translator: A system program that 
reads another program written in a particular 
programming language and either executes it 
directly or converts it into some other language 
(such as machine language) for later execution. 
See interpreter, compiler, assembler. 


leading zero: A zero occurring at the beginning 
of a decimal number, deleted by most computing 
programs. 


least significant bit: The rightmost bit of a 
binary number. The least significant bit 
contributes the smallest quantity to the value of the 
number. Compare most significant bit. 


Glossary 361 


LIFO: Acronym for “first in, last out” order, as in 
a stack. 


line: See program line. 


line feed: An ASCII character (decimal 10) that 
ordinarily causes a printer or video display to 
advance to the next line. 


line number: A number identifying a program 
line in an Applesoft BASIC program. 


line width: The number of characters that fit on a 
line on the screen or on a page. 


list: To display on a monitor, or print on a 
printer, the contents of memory or of a file. 


load: To transfer information from a peripheral 
storage medium (such as a disk) into main 
memory for use—for example, to transfer a 
program into memory for execution. 


location: See memory location. 


logic: (1) In microcomputers, a mathematical 
treatment of formal logic using a set of symbols to 
represent quantities and relationships that can be 
translated into switching circuits, or gates. AND, 
OR, and NOT are examples of logical gates. Each 
gate has two states, open or closed, allowing the 
application of binary numbers for solving 
problems. (2) The systematic scheme that defines 
the interactions of signals in the design of an 
automatic data processing system. 


logical operator: An operator, such as AND, 
that combines logical values to produce a logical 
result, such as true or false; sometimes called a 
Boolean operator. Compare arithmetic 
operator, relational operator. 


logic board: See main logic board. 


loop: A section of a program that is executed 
repeatedly until a limit or condition is met, such as 
an index variable’s reaching a specified ending 
value. 


loop variable: See index variable. 
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low-level language: A programming language 
that is relatively close to the form the computer's 
processor can execute directly. One statement in a 
low-level language corresponds to a single 
machine-language instruction. Examples are 6502 
machine language, 6502 assembly language, and 
68000 machine and assembly languages. Compare 
high-level language. 


low-order byte: The less significant half of a 
memory address or other two-byte quantity. In the 
6502 microprocessor used in the Apple II family of 
computers, the low-order byte of an address is 
usually stored first, and the high-order byte 
second. The opposite is true for Macintosh 
computers. 


low-power Schottky (LS): A type of transistor- 
transistor logic (ITL) integrated circuit having 
lower power and higher speed than a conventional 
TIL integrated circuit; named for Walter Schottky 
(1886-1956), a semiconductor physicist. 


low-resolution graphics: The display of 
graphics on a display screen as a 16-color array of 
blocks, 40 columns wide and 48 rows high. For 
example, on a Macintosh when the text window is 
in use, the visible low-resolution graphics display 
is 40 by 40 plotting points—that is, 40 by 40 pixels. 
See high-resolution graphics. 


LS: See low-power Schottky. 


machine language: The form in which 
instructions to a computer are stored in memory 
for direct execution by the computer’s processor. 
Each model of computer processor (such as the 
6502 microprocessor used in the Apple II family of 
computers) has its own form of machine language. 


mainframe computer: A central processing 
unit or computer that is larger and more powerful 
than a minicomputer or a personal computer 
(microcomputer). Frequently called simply a 
mainframe for short. The Apple Access II 
program and MacTerminal make it possible to 
communicate with mainframe computers over 
telecommunications media. 


main logic board: A large circuit board that 
holds RAM, ROM, the microprocessor, custom- 
integrated circuits, and other components that 
make the computer a computer. 


main memory: The part of a computer's 
memory whose contents are directly accessible to 
the microprocessor; usually synonymous with 
random-access memory (RAM). Programs are 
loaded into main memory, and that’s where the 
computer keeps information while you’re working. 
Sometimes simply called memory. See also read- 
only memory, read-write memory. 


MARK parity: A bit of value 1 appended to a 
binary number for transmission. The receiving 
device checks for errors by looking for this value 
on each character. Compare even parity, odd 
parity. 


megabyte: A unit of measurement equal to 1024 
kilobytes, or 1,048,576 bytes; abbreviated Mb. See 
kilobyte. 


memory: A hardware component of a computer 
system that can store information for later 
retrieval. See main memory, random-access 
memory, read-only memory, read-write 
memory. 


memory location: A unit of main memory that 
is identified by an address and can hold a single 
item of information of a fixed size. In the Apple II 
family of computers, a memory location holds 
one byte, or eight bits, of information. 


memory-resident: (1) Stored permanently in 
memory as firmware (ROM). (2) Held continually 
in memory even while not in use. DOS is a 
memory-resident program. 


menu: A list of choices presented by a program, 
from which you can select an action. 


MHz: Megahertz; one million hertz. See hertz. 


microcomputer: A computer, such as any of the 
Apple II or Macintosh computers, whose 
processor is a microprocessor. 


microprocessor: A computer processor 
contained in a single integrated circuit, such as the 
6502 or 65C02 microprocessor used in the Apple II 
family of computers and the 68000 

microprocessor used in the Macintosh family. The 
microprocessor is the central processing unit 
(CPU) of the microcomputer. 


microsecond: One millionth of a second. 
Abbreviated Ls. 


millisecond: One thousandth of a second. 
Abbreviated ms. 


mode: A state of a computer or system that 
determines its behavior. A manner of operating. 


modem: Short for MOdulator/DEModulator. A 
peripheral device that links your computer to 
other computers and information services using 
the telephone lines. 


modifier key: A key (Apple, Caps Lock, 
Control, Option, Shift) that generates no 
keyboard events of its own, but changes the 
meaning of other keys or mouse actions. Also 
called a control key. 


modulate: To modify or alter a signal so as to 
transmit information. For example, conventional 
broadcast radio transmits sound by modulating 
the amplitude (amplitude modulation, or AM) or 
the frequency (frequency modulation, or FM) of a 
carrier signal. 


monitor: See video monitor. 


Monitor program: A system program built into 
the firmware of some computers, used for directly 
inspecting or changing the contents of main 
memory and for operating the computer at the 
machine-language level. The Monitor program 
activates the disk drive when you turn on the 
computer. 
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most significant bit: The leftmost bit of a binary 
number. The most significant bit contributes the 
largest quantity to the value of the number. For 
example, in the binary number 10110 (decimal 
value 22), the leftmost bit has the decimal value 16 
(2%). Compare least significant bit. 


mouse: A small device you move around on a 
flat surface next to your computer. The mouse 
controls a pointer on the screen whose 
movements correspond to those of the mouse. 
You use the pointer to select menu items, to move 
data, and to draw with in graphics programs. 


mouse button: The button on the top of the 

mouse. In general, pressing the mouse button 
initiates some action on whatever is under the 

pointer, and releasing the button confirms the 
action. 


nanosecond: One billionth of a second. 
Abbreviated ns. 


nested loop: A loop contained within the body 
of another loop and executed repeatedly during 
each pass through the outer loop. See loop. 


nested subroutine call: A call to a subroutine 
from within the body of another subroutine. 


nibble: A unit of data equal to half a byte, or four 
bits. A nibble can hold any value from 0 to 15. 


NOT: A unary logical operator that produces a 
true result if its operand is false, and a false result if 
its operand is true. Compare AND, OR, exclusive 
OR. 


NTSC: (1) Abbreviation for National Television 
Standards Committee. The committee that 
defined the standard format used for transmitting 
broadcast video signals in the United States. (2) 
The standard video format defined by the NTSC. 


object code: See object program. 


object program: The translated form of a 
program produced by a language translator such 
as a compiler or assembler. Also called object 
code. Compare source program. 
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odd parity: In data transmission, the use of an 
extra bit set to 0 or 1 as necessary to make the total 
number of 1 bits an odd number; used as a means 
of error checking. Compare even parity, MARK 
parity. 

opcode: See operation code. 


Open Apple: A control key on the 
Apple II-family keyboards; on later keyboards, 
simply called the Apple key. 


operand: A value to which an operator is 
applied. The value on which an operation code 
operates. Compare argument. 


operating system: A program that organizes 
the actions of the parts of the computer and its 
peripheral devices. 


operation code: The part of a machine-language 
instruction that specifies the operation to be 
performed. Often called opcode. 


operator: A symbol or sequence of characters, 
such as + or AND, specifying an operation to be 
performed on one or more values (the operands) 
to produce a result. See arithmetic operator, 
relational operator, logical operator, unary 
operator, binary operator. 


option: (1) Something chosen or available as a 
choice; for instance, items in a menu. (2) An» 
argument whose provision is optional. 


OR: A logical operator that produces a true result 
if either or both of its operands are true, and a 
false result if both of its operands are false. 
Compare exclusive OR, AND, NOT. 


output: Information transferred from a computer 
to. some external destination, such as the display 
screen, a disk drive, a printer, or a modem. 


output routine: A machine-language routine 
that performs the sending of characters. The 
standard output routine sends characters to the 
screen. A different output routine might, for 
example, send them to a printer. 


overflow: The condition that exists when an 
attempt is made to put more data into a given 
memory area than it can hold; for example, a 
computational result that exceeds the allowed 
range. 


override: To modify or cancel an instruction by 
issuing another one. 


overrun: A condition that occurs when the 
processor does not retrieve a received character 
from the receive data register of the Asynchronous 
Communications Interface Adapter (ACIA) before 
the subsequent character arrives. The ACIA 
automatically sets bit 2 COVR) of its status register; 
subsequent characters are lost. The receive data 
register contains the last valid data word received. 


page: (1) A screenful of information on a video 
display. In the Apple II family of computers, a 
page consists of 24 lines of 40 or 80 characters 
each. (2) An area of main memory containing text 
or graphical information being displayed on the 
screen. (3) A segment of main memory 256 bytes 
long and beginning at an address that is an even 
multiple of 256. 


page zero: See zero page. 


parallel interface: An interface in which 
several bits of information (typically eight bits, or 
one byte) are transmitted simultaneously over 
different wires or channels. Compare serial 
interface. 


parity: Sameness of level or count, usually the 
count of 1 bits in each character, used for error 
checking in data transmission. See even parity, 
MARK parity, odd parity, parity bit. 


Pascal: A high-level programming language with 
statements that resemble English phrases. Pascal 
was designed to teach programming as a 
systematic approach to problem solving. Named 
after the philosopher and mathematician Blaise 
Pascal. 


pass: A single execution of a loop. 
PC board: See printed-circuit board. 


peek: To read information directly from a 
location in the computer’s memory. 


peripheral: (adj) At or outside the boundaries of 
the computer itself, either physically (as a 
peripheral device) or in a logical sense (as a 
peripheral card). (n) Short for peripheral device. 


peripheral bus: The bus used for transmitting 
information between the computer and peripheral 
devices connected to the computer's expansion 
slots or ports. 


peripheral card: A removable printed-circuit 
board that plugs into one of the computer’s 
expansion slots. Peripheral cards allow the 
computer to use peripheral devices or to perform 
some subsidiary or peripheral function. 


peripheral device: A piece of hardware—such as 
a video monitor, disk drive, printer, or 
modem—used in conjunction with a computer 
and under the computer’s control. Peripheral 
devices are often (but not necessarily) physically 
separate from the computer and connected to it by 
wires, cables, or some other form of interface. 
They often require peripheral cards. 


peripheral slot: See expansion slot. 


phase: (1) A stage in a periodic process. A point 
in a cycle. For example, the 6502 microprocessor 
uses a clock cycle consisting of two phases called ® 
0 and @ 1. (2) The relationship between two 
periodic signals or processes. 


PILOT: Acronym for Programmed Inquiry, 
Learning, Or Teaching. A high-level programming 
language designed for teachers and used to create 
computer-aided instruction (CAD lessons that 
include color graphics, sound effects, lesson text, 
and answer checking. SuperPILOT is an enhanced 
version of the original Apple II PILOT 
programming language. 
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pipelining: A feature of a processor that enables 
it to begin fetching the next instruction before it 
has finished executing the current instruction. All 
else being equal, processors with this feature run 
faster than those without it. 


pixel: Short for picture element. A point on the 
graphics screen; the visual representation of a 
bit on the screen (white if the bit is 0, black if 

it’s 1). Also, a location in video memory that 
maps to a point on the graphics screen when the 
viewing window includes that location. 


plotting vector: A code representing a single 
step in drawing a shape on the high-resolution 
graphics screen. The plotting vector specifies 
whether to plot a point at the current screen 
position, and in what direction to move (up, 
down, left, or right) before processing the next 
vector. 


pointer: An item of information consisting of the 
memory address of some other item. For 
example, Applesoft BASIC maintains internal 
pointers to the most recently stored variable, the 
most recently typed program line, and the most 
recently read data item, among other things. The 
6502 uses one of its internal registers as a pointer to 
the top of the stack. 


point of call: The point in a program from which 
a subroutine or function is called. 


poke: To store information directly into a 
location in the computer’s memory. 


pop: To remove the top entry from a stack, 
moving the stack pointer to the entry below it. 
Synonymous with pull. Compare push. 


power supply: A circuit that draws electrical _ 
power from a power outlet and converts it to the 
kind of power the computer can use. 


power supply case: The metal case inside most 
Apple II and Macintosh computers that houses the 
power supply. The Apple IIc uses an external 
power supply case. 
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PR#: An Applesoft BASIC command that sends 
output to a slot or a machine-language program. It 
specifies an output routine in the ROM ona 
peripheral card or in a machine-language routine 
in RAM by changing the address of the standard 
output routine used by the computer. 


precedence: The order in which operators are 
applied in evaluating an expression. Precedence 
varies from language to language, but usually 
resembles the precedence rules of algebra. 


printed-circuit board: A hardware component 
of a computer or other electronic device, 
consisting of a flat, rectangular piece of rigid 
material, commonly Fiberglas, to which 
integrated circuits and other electronic 
components are connected. 


procedure: In the Pascal and Logo programming 
languages, a set of instructions that work as a unit, 
approximately equivalent to the term subroutine 
in BASIC. 


processor: The hardware component of a 
computer that performs the actual computation by 
directly executing instructions represented in 
machine language and stored in main memory. 
See microprocessor. 


ProDOS: An Apple II operating system designed 
to support hard disk drives like the ProFile, as well 
as floppy disk storage devices. ProDOS stands for 
Professional Disk Operating System. Compare 
DOS. 


ProDOS command: Any one of the 28 
commands recognized by ProDOS. 


program: (n) A set of instructions describing 
actions for a computer to perform in order to 
accomplish some task, conforming to the rules 
and conventions of a particular programming 
language. (v) To write a program. 


program line: The basic unit of an Applesoft 
BASIC program, consisting of one or more 
statements separated by colons (). 


programming language: A set of symbols and 
associated rules or conventions for writing 
programs. BASIC, Logo, and Pascal are 
programming languages. 


prompt: A message on the screen that tells you of 
some need for response or action. A prompt 
usually takes the form of a symbol, a message, a 
dialog box, or a menu of choices. 


prompt character: A text character displayed 
on the screen, usually just to the left of a cursor, 
where your next action is expected. The prompt 
character often identifies the program or 
component of the system that’s prompting you. 
For example, Applesoft BASIC uses a square 
bracket prompt character (]); Integer BASIC, an 
angle bracket (>); and the System Monitor 
program, an asterisk (*). 


prompt line: A specific area on the display 
reserved for prompts. 


protocok A formal set of rules for sending and 
receiving data on a communication line. 


push: To add an entry to the top of a stack, 
moving the stack pointer to point to it. Compare 


pop. 


queue: A list in which entries are added at one 
end and removed at the other, causing entries to 
be removed in first-in, first-out (FIFO) order. 
Compare stack, 


QWERTY keyboard: The standard layout of keys 
on a typewriter keyboard, its name is formed from 
the first six letters on the top row of letter keys. 
Compare Dvorak keyboard. 


radio-frequency (RF) modulator: A device that 
makes your television set work as a monitor. 


RAM: See random-access memory. 


random-access memory (RAM): Memory in 
which information can be referred to in an 
arbitrary or random order. As an analogy, a book 
is a random-access storage device in that it can be 
opened and read at any point. RAM usually means 
the part of memory available for programs from a 
disk; the programs and other data are lost when 
the computer is turned off. A computer with 512K 
RAM has 512 kilobytes available to the user. 
(Technically, the read-only memory (ROM) is 
also random access, and what’s called RAM 
should correctly be termed read-write memory.) 
Compare read-only memory, read-write 
memory. 


random-access text file: A text file that is 
partitioned into an unlimited number of uniform- 
length compartments called records. When you 
open a random-access text file for the first time, 
you must specify its record length. No record is 
placed in the file until written to. Each record can 
be individually read from or written to—hence, 
random-access. 


raster: The pattern of parallel lines making up 
the image on a video display screen. The image is 
produced by controlling the brightness of 
successive points on the individual lines of the 
raster. 


read: To transfer information into the 
computer’s memory from outside the computer 
(such as a disk drive or modem) or into the 
computer’s processor from a source external to 
the processor (such as the keyboard or main 
memory). 


read-only memory (ROM): Memory whose 
contents can be read, but not changed; used for 
storing firmware. Information is placed into 
read-only memory once, during manufacture; it 
then remains there permanently, even when the 
computer’s power is turned off. Compare 
random-access memory, read-write 
memory. 
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read-write memory: Memory whose contents 
can be both read and changed (or written to). The 
information contained in read-write memory is 
erased when the computer’s power is turned off 
and is permanently lost unless it has been saved on 
a disk or other storage device. Compare random- 
access memory, read-only memory. 


real number: In computer usage, a number that 
may include a fractional part; represented inside 
the computer in floating-point form. Because a 
real number is of infinite precision, this 
representation is usually approximate. Compare 
integer. 


register: A location in a processor or other chip 
where an item of information is held and modified 
under program control. 


relational operator: An operator, such as >, 
that operates on numeric values to produce a 
logical result. Compare arithmetic operator, 
logical operator. 


reserved word: A word or sequence of 
characters reserved by a programming language 
for some special use and therefore unavailable as a 
variable name in a program. 


resident: See memory-resident, disk- 
resident. 


return address: The point in a program to 
which control returns on completion of a 
subroutine or function. 


RF modulator: See radio-frequency 
modulator. 


RGB monitor: A type of color monitor that 
receives separate signals for each color (red, 
green, and blue). See composite video. 


ROM: See read-only memory. 


routine: A part of a program that accomplishes 
some task subordinate to the overall task of the 
program. 


row: A horizontal arrangement of character cells 
or graphics pixels on the screen. 
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RS-232 cable: Any cable that is wired in 
accordance with the RS-232 standard, which is the 
common serial data communication interface 
standard. 


run: (1) To execute a program. When a program 
runs, the computer performs the instructions. (2) 
To load a program into main memory from a 
peripheral storage medium, such as a disk, and 
execute it. 


save: To store information by transferring the 
information from main memory to a disk. Work 
not saved disappears when you turn off the 
computer or when the power is interrupted. 


screen: See display screen. 


scroll: To move all the text on the screen upward 
or downward, and, in some cases, sideways. See 
viewport, window. 


serial interface: An interface in which 
information is transmitted sequentially, a bit at a 
time, over a single wire or channel. Compare 
parallel interface. 


setup time: The amount of time a signal must be 
valid in advance of some event. Compare hold 
time. 


silicon (Si): A solid, crystalline chemical 
element from which integrated circuits are made. 
Silicon is a semiconductor; that is, it conducts 
electricity better than insulators, but not as well as 
metallic conductors. Silicon should not be 
confused with silica—that is, silicon dioxide, such 
as quartz, opal, or sand—or with silicone, any of a 
group of organic compounds containing silicon. 


simple variable: A variable that is not an 
element of an array. 


6502: The microprocessor used in the Apple II, 
in the Apple II Plus, and in early models of the 
Apple Ile. 


65C02: The microprocessor used in the 
enhanced Apple Ile, the extended keyboard Ile, 
and the Apple IIc. 


68000: The microprocessor used in the 
Macintosh and Macintosh Plus. 


slot: A narrow socket inside the computer where 
you can install peripheral cards. Also called an 
_ expansion slot. 


soft switch: Also called a software switch; a 
means of changing some feature of the computer 
from within a program. For example, DIP switch 
settings on ImageWriter printers can be 
overridden with soft switches. Specifically, a soft 
switch is a location in memory that produces some 
special effect whenever its contents are read or 
written. 


software: A collective term for programs, the 
instructions that tell the computer what to do. 
They’re usually stored on disks. Compare 
hardware, firmware. 


source code: See source program. 


source program: The form of a program given 
to a language translator, such as a compiler or 
assembler, for conversion into another form; 
sometimes called source code. Compare object 
program. 


space character: A text character whose printed 
representation is a blank space, typed from the 
keyboard by pressing the Space bar. 


stack: A list in which entries are added (pushed) 
or removed (popped) at one end only (the top of 
the stack), causing them to be removed in last-in, 
first-out (LIFO) order. Compare queue. 


standard instruction: An instruction 
automatically present when no superseding 
instruction has been received. 


starting value: The value assigned to the index 
variable on the first pass through a loop. 


start up: To get the system running. Starting up is 
the process of first reading the operating system 
program from the disk, and then running an 
application program. 


startup disk: A disk with all the necessary 
program files—such as the Finder and System files 
contained in the System folder in Macintosh—to 
set the computer into operation. In Apple II, 
sometimes called a boot disk. 


statement: A unit of a program in a high-level 
language that specifies an action for the computer 
to perform. A statement typically corresponds to 
several instructions of machine language. 


step value: The amount by which the index 
variable changes on each pass through a loop. 


string: An item of information consisting of a 
sequence of text characters. 


strobe: A signal whose change is used to trigger 
some action. 


subroutine: A part of a program that can be 
executed on request from another point in the 
program and that returns control, on completion, 
to the point of the request. 


synchronous: A mode of data transmission in 
which a constant time interval exists between 
transmission of successive bits, characters, or 
events. Compare asynchronous. 


synchronous transmission: A transmission 
process that uses a clocking signal to ensure an 
integral number of unit (time) intervals between 
any two characters. Compare asynchronous 
transmission. 


syntax: (1) The rules governing the structure of 
statements or instructions in a programming 
language. (2) A representation of a command that 
specifies all the possible forms the command can 
take. 


system: A coordinated collection of interrelated 
and interacting parts organized to perform some 
function or achieve some purpose—for example, 
a computer system comprising a processor, 
keyboard, monitor, and disk drive. 


system configuration: See configuration. 
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system program: A program that makes the 
resources and capabilities of the computer 
available for general purposes, such as an 
operating system or a language translator. 
Compare application program. 


system software: The component of a 
computer system that supports application 
programs by managing system resources such as 
memory and I/O devices. 


TAB: An ASCII character that commands a 
device such as a printer to start printing at a preset 
location (called a tab stop). There are two such 
characters: horizontal tab Chex 09) and vertical tab 
chex 0B). TAB works like the tabs on a typewriter. 


television set: A display device capable of 
receiving broadcast video signals (such as 
commercial television broadcasts) by means of an 
antenna. Can be used in combination with a 
radio-frequency modulator as a display device for 
the Apple II family of computers. Compare video 
monitor. 


text: (1) Information presented in the form of 
readable characters. (2) The display of characters 
on a display screen. Compare graphics. 


text window: An area on the video display 
screen within which text is displayed and scrolled. 


traces: Electrical paths that connect the 
components on a circuit board. 


transistor-transistor logic (TTL): (1) A family 
of integrated circuits having bipolar circuit logic; 
TTLs are used in computers and related devices. 
(2) A standard for interconnecting such circuits, 
which defines the voltages used to represent 
logical zeros and ones. 


troubleshoot: To locate and correct the cause of 
a problem or malfunction, especially in hardware. 
Compare debug. 


TTL: See transistor-transistor logic. 
turnkey disk: See startup disk. 
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unary operator: An operator that applies to a 
single operand. For example, the minus sign ©) in 
a negative number such as -6 is a unary arithmetic 
operator. Compare binary operator. 


unconditional branch: A branch that does not 
depend on the truth of any condition. Compare 
conditional branch. 


value: An item of information that can be stored 
in a variable, such as a number or a string. 


variable: (1) A location in the computer's 
memory where a value can be stored. (2) The 
symbol used in a program to represent such a 
location. Compare constant. 


vector: (1) The starting address of a program 
segment, when used as a common point for 
transferring control from other programs. (2) A 
memory location used to hold a vector, or the 
address of such a location. 


video: (1) A medium for transmitting 
information in the form of images to be displayed 
on the screen of a cathode-ray tube. (2) 
Information organized or transmitted in video 
form. 


video monitor: A display device that can receive 
video signals by direct connection only, and that 
cannot receive broadcast signals such as 
commercial television. Can be connected directly 
to the computer as a display device. Compare 
television set. 


viewport: All or part of the display screen used 
by an application program to display a portion of 
the information (such as a document, picture, or 
worksheet) on which a program is working. 
Compare window. 


volume: A general term referring to a storage 
device; a source of or a destination for 
information. A volume has a name and a volume 
directory with the same name. Its information is 
organized into files. 


warm start: The process of transferring control 
back to the operating system in response to a 
failure in an application program. Compare cold 
start. 


. window: The portion of a collection of 
information (such as a document, picture, or 
worksheet) that is visible in a viewport on the 
display screen. Compare viewport. 


word: A group of bits that is treated as a unit; the 
number of bits in a word is a characteristic of each 
particular computer. 


write: To transfer information from the 
computer to a destination external to the 
computer (such as a disk drive, printer, or 
modem) or from the computer’s processor to a 
destination external to the processor (such as 
main memory). 


write-enable notch: The square cutout on one 
edge of a 5.25-inch disk’s jacket. If there is no 
write-enable notch, or if it is covered with a write- 
protect tab, the disk drive can read information 
from the disk, but cannot write on it. 


write protect: To protect the information on a 
5.25-inch disk by covering the write-enable notch 
with a write-protect tab, preventing the disk drive 
from writing any new information onto the disk. 
Compare copy protect. 


write-protect tab: (1) A small adhesive sticker 
used to write protect a 5.25-inch disk by covering 
the write-enable notch. (2) The small plastic tab in 
the corner of a 3.5-inch disk jacket. You lock (write 
protect) the disk by sliding the tab toward the edge 
of the disk; you unlock the disk by sliding the tab 
back so that it covers the rectangular hole. 


X register: One of the two index registers in the 
6502 microprocessor. 


Y register: One of the two index registers in the 
6502 microprocessor. 


zero page: The first page (256 bytes) of memory 
in the Apple II family of computers, also called 
page zero. Since the high-order byte of any 
address in this page is zero, only the low-order 
byte is needed to specify a zero-page address; this 
makes zero-page locations more efficient to 
address, in both time and space, than locations in 
any other page of memory. 
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Cast of Characters 


* (asterisk) as prompt character 
62 

“ (caret) 122, 125 

(colon) as Monitor command 

105 

> (greater than sign) as prompt 
character 62 

& (Open Apple) 11-14, 228 

(period) as Monitor command 

102 

20 (phi 0) 162-163, 167, 
170-172, 180-181 

21 (phi 1) 162-163, 167, 
170-172, 180-181 

@2 (phi 2) 162 

? (question mark) as prompt 
character 62 

] Gight bracket) as prompt 
character 62 

@ (Solid Apple) 11-14, 228 


A 


Al 92 
A2 92 
A4 92 
accurhulator 138, 148 
ACIA 286 
address bus 161-162 
addressing 
display pages 31-37, 174-179 
indirect 77 
I/O locations 138-139 
RAM 139, 169-171 
relative 121, 126, 137 
ROM 168-169 
address transformation 177 
ALTCHAR soft switch 29 
alternate character set 19-20, 228 
on original Ie 20 


index 


ALTZP soft switch 84, 89-90 
analog inputs 42-43 
animation 231 
annunciators 40-41, 43 
any-key-down flag 13 
Apple keys 11-14 
differences in Apple II family 
228 
Applesoft BASIC xxi, 12, 105, 235 
and lowercase xxii 
and uppercase 48-49 
80-column support xxi 
tabbing with original Apple Ile 
271-272 
use of page 3 78 
use of page zero 77, 79-81 


Apple II compatibility with Apple Ile 


48-50 


Apple II family differences 227-232 


Apple IIc interrupt differences 156 
Apple Ile, differences between 
original and enhanced xix—xxiii 
ASCII input mode 107 
COUT1 subroutine 56 
interrupt support 132, 148-149 
microprocessor 6 
Mini-Assembler 123-125 
Monitor Search command 110 
MouseText 12, 20 
slot 3 144 
tabbing in Applesoft 271-272 
using Caps Lock 49 


Apple He 80-Column Text Card 86, 


134, 267-275 
Apple Ile Extended 80-Column 
Text Card 86, 134, 267-275 
A register 146 
arithmetic, hexadecimal 116 
arrow keys 61, 63-64 
ASCII codes 14-16 
ASCII input mode 106-107 


assemblers 121 
assembly language 234 
asterisk (*) as prompt character 62 
auxiliary firmware 86-93 
auxiliary memory 86-93 
differences in Apple II family 
229 
map 87 
moving data to 92 
soft switches 89 
subroutines 91 
auxiliary RAM 86-88 
auxiliary slot 7, 49 
differences in Apple II family 
229 
signals 197-200 
AUXMOVE subroutine 91-92 


backspacing 63 
bank-switched memory 82-86, 87, 
229 
map 82 
bank switches 83-85 
reading 86 
BASIC, Applesoft See Applesoft 
- BASIC 
BASIC, Integer See Integer 
BASIC 
BASICIN subroutine 58, 220 
address in I/O link 53 
BASIC Monitor command 115 
BASICOUT subroutine 65, 220 
address in I/O link 53 
baud rate for SSC 279 
BEL character 53 
BELL subroutine 221 
BELL1 subroutine 39, 221 
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bit definition 236 

bit mapping of graphics 23-26 
booting 267-268 

break instructions 155 

BRK handler 155 

BRK instruction 155 

BRK vector 148 

BS character 53 

byte definition 237 


Cc 


canceling lines 63 
CAN character 54 
Caps Lock 11 
for older software compatibility 
49 
caret (*) 122, 125 
carriage returns with SSC 281 
cassette I/O 39-40, 188 
commands 111-114 
soft switches 39 
central processing unit (CPU) 4-6 
See also 65C02 microprocessor 
CH 52 
changing memory contents 
105-110 
character code 12 
character generator ROM 178 
character sets, text 19-20 
differences among Apple II 
models 228 
CHARGEN signal 185 
circuit board 4-7 
connectors 7 
clear-strobe switch 12 
CLEOLZ subroutine 50, 69, 219 
clock rate 161 
clock signals 162 
CLREOL subroutine 50, 64, 221 
CLREOP subroutine 50, 64, 221 
CLRSCR subroutine 64, 221 
CLRTOP subroutine 64, 221 
cold-start reset 95 
colon (:) as Monitor command 105 
color graphics with black-and-white 
monitors 16 
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colors 
double-high-resolution graphics 
25-26, 185 
high-resolution graphics 23-25, 
183-184 
low-resolution graphics 21-22, 
182 
command characters, Monitor 101 
comma tabbing with original 
Apple IIe 271 
complementary decimal values 12 
connectors 
back panel 8 
cassette I/O 8, 39 
D-type 8, 40 
game I/O 7, 13 
hand control 8, 40-43 
9-pin 8, 40 
phone jacks 8, 39 
power 160 
RCA-type jack 8 
video monitor 8, 186 
Control 11 
control characters 244, 248 
with BASICOUT 53-55 
with COUT1 53-55 
with 80-column firmware 
273-274 
with Pascal I/O protocol 70-71 
Control-B Monitor command 115 
Control-C Monitor command 115 
Control-E Monitor command 111 
Control-K Monitor command 115 
Control-P Monitor command 115 
Control-U 50 
Control-X 63 
Control-Y Monitor command 119 
COUT subroutine 50-52, 64, 221 
deactivating 80-column firmware 
50 
COUT1 subroutine 51-53, 64, 136, 
222 
address in I/O link 51 
on original Apple Ile 56 
cover 2 
CP/M 234 
starting up with 268 


CPU 4-6 
See also 65C02 microprocessor 

CR character 53 
CROUT subroutine 64, 222 
CROUT1 subroutine 64, 222 
CSW link 140-141 
current, supply 159-160 
cursor-control keys 11 
cursor motion in escape mode 

60-61 
cursor position 52-58 
custom IC’s 164-168 
CV 52 
cycle stealing 170 


D 

daisy chains, interrupt and DMA 
193-195, 208 

data bus 161 

data format for SSC 279 

DCl1 character 54 

DC2 character 54 


DC3 character 54 
decimal values 12 
converting to hexadecimal 
238-239 
negative 239-240 
device assignment, peripheral card 
145 
device identification 145 
DEVICE SELECT’ signal 133 
DHIRES soft switch 30 
Diagnostics ROM 168 
differences among Apple II models 
227-232 
differences between original and 
enhanced Apple Ile xix—xxii 
ASCII input mode 106-107 
COUT1 subroutine 56 
interrupt support 132, 148-149 
microprocessor 6 
Mini-Assembler 123 
Monitor Search command 110 
MouseText 17, 20 
slot 3 144 
tabbing in Applesoft 269 
using Caps Lock 49 
disassemblers 121 


display, video 16-37 
address transformation 175-176 
double-high-resolution graphics 
184-185 
80-column text 179 
formats 18, 57 
40-column text 179 
generation 173-185, 231 
high-resolution graphics 183-184 
low-resolution graphics 181-182 
memory addressing 174-178 
modes 17, 19-26, 28-31, 
178-185 
pages 23, 25, 27-28, 31-37, 
78-79 
refreshing 170-171 
specifications 17 
text 178-181 
DMA daisy chain 193-195, 208 
DOS 3.3 xx, 140, 233 
and uppercase 48-49 
starting up with 268 
use of page 3. 78 
use of page zero 81 
double-high-resolution graphics 
17, 18, 25-26 
colors 26 
display pages 27 
generation 184-185 
map 37 
memory pages 25 
double-high-resolution Page 1 79 
D-type connector 8 


E 


editing with GETLN 63-64 
80COL soft switch 29 
80-column firmware xxi, 49-50 

activating 50 

control characters with 272-275 
80-column text 21, 22 

differences in Apple II family 

228 

display pages 27-28 

generation 178-179 

map 34 

signals 197-198 

with Applesoft xxi 

with Pascal xxi 

with TV set 16 


80-Column Text Card 86, 134, 
150, 267-275 

80STORE soft switch 29, 32, 87, 
89, 90, 198 

EM character 55 

EN80’ signal 198 

enhanced Apple Ile See 
differences between original 
and enhanced Apple Ile 


ENKBD’ signal 187 

entry points for I/O routines 
145-146 

escape codes 60-61 

escape mode 60-61 

ESC character 55 

ETB character 54 

EXAMINE command 110-111 

examining memory 102 

expansion ROM space 133-135 

expansion slot 3 49-50 

expansion slots 7, 132-144 

signals 191-197 

Extended 80-Column Text 
Card 86, 134, 267-275 

extended keyboard Apple Ie xxiii 


F 


FF character 54 
firmware 
auxiliary 86-93 
80-column xxi, 49-50 
1/O 46-71 
Monitor subroutines 46-71 
Pascal 1.1 protocol 68-71, 
145-146 
slot 3 69 
flag, any-key-down 13 
FLASH command 270-271 
flashing format 19-20, 57-58 
forced cold-start reset 96 
Fortran 235 
40-column text 21, 22 
display pages 27-28 
generation 178-179 
memory map 33, 177 
with TV set 16 
14M signal 163 
FS character 55 


G 


game I/O 
connectors 13 
signals 190-191 
GET command 269 
GETLN subroutine 58, 62-64, 222 
editing with 63-64 
input buffer 78 
line length 3 
used by Monitor 101 
with 80-column card 269 
GETLN1 subroutine 222 
GETLNZ subroutine 222 
GO command 120 
graphics See double-high- 
resolution graphics; 
high-resolution graphics; 
low-resolution graphics 
graphics modes 21-26 
bit-mapping 23-26 
greater than sign (>) as prompt 
character 62 
GS character 55 


H 


hand control connectors 8, 40-43 
hard disk with Pascal xxii 
hexadecimal arithmetic 116 
hexadecimal values 12 
converting to decimal 238-239 
converting to negative decimal 
239-240 
high-resolution graphics 17, 18, 
23-25 
addressing display pages 31, 36 
bit patterns 241-242 
colors 24-25, 183-184 
display pages 23, 27 
generation 183-184 
map 36 
high-resolution Page 1 23, 27, 79 
high-resolution Page 2 23, 79 
HIRES soft switch 29, 30, 89 
HLINE subroutine 67, 222 
HOME command 270-271 
HOME subroutine 50, 67, 223 
HTAB command xxi 
with original Apple Ile 271-272 
humidity, operating 158 
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I, J 
identification byte xx, 231 
IN# command 115 
index register 138 
indirect addressing 77 
input buffer 78 
INPUT command 269 
input devices See I/O devices 
input/output See I/O 
Input/Output Unit (OU) 5, 6, 
166-167, 186-187 
inputs 
analog 38, 42-43 
hand control 38 
secondary 38-43 
switch 41-42, 43 
See also I/O devices 
Integer BASIC 12, 235 
and bank-switched memory 82 
and reset 83 
and uppercase 49 
use of page 3 78 
use of page zero 77, 79-81 
interpreter ROM 5 
interrupt handler 
built-in 147, 151 
user’s 154-155 
interrupts 147-156 
and card in auxiliary slot 50 
daisy chain 193, 204 
definition 147 
original Apple Ile differences 
148 
priority 147 
sequence 152 
interrupt vector 151 
INT IN pin 147 
INT OUT pin 147 
INVERSE command 270-271 
inverse display format 19-20, 
57-58, 114 


378 Index 


YO 
addressing 138-139 
circuits 186-191 
devices, built-in 9-43 
entry points 145-146 
firmware, built-in 45-71 
links 51, 78, 140-141 
memory for peripheral cards 
133 
memory map 142 
Pascal protocol 68-76, 144, 
145-146 
switching memory 142-143 
IOREST subroutine 223 
IOSAVE subroutine 223 
1/O SELECT’ signal 133-134 
IOU (nput/Output Unit) 5, 6, 
166-167, 186-187 
IOUDIS soft switch 30 
IRQ vector 147-148 
IRQ’ signal 148 


K 


KBD’ signal 187 
keyboard 3, 10-16 
automatic repeat function 10 
circuits 187-188 
differences in Apple II family 
227 
memory locations 12 
rollover 10 
KEYBOARD command 115 
keyboard encoder 5, 12 
keyboard ROM 5 
keyboard strobe 13 
KEYIN subroutine 58, 59-60, 223 
address in I/O link 51 
keypad 188 
keys and ASCII codes 14-16 
KSW link 140 


L 


language card 86 
differences in Apple II family 
229 
LED 2 
Left Arrow 63 
LF character 53, 54 
line feeds with SSC 281 
links, I/O 51 
address storage 78 
changing 140-141 
LIST command 121-122 
low-resolution graphics 17, 18, 
21-23 
colors 23 
display pages 27 
generation 181-182 
map 35 
with TV set 16 


M 


machine language 120-122 
mapping display addresses 
175-177 
maps See memory maps 
memory 
addressing 168 
auxiliary 86-93 
bank-switched 82-86, 87, 229 
changing contents 105-110 
display 174-178 
dump 102-104 
examining 102 
filling 117-118 
for peripheral cards 132-136 
I/O space 142-143 
organization 74-98 
sharing 91 
text window locations 56-57 
used by SSC 287 
Memory Management Unit (MMU) 
5, 6, 164-165 


memory maps 
auxiliary memory 87 
bank-switched areas 82 
double-high-resolution graphics 
37 
80-column text 34 
40-column text 33, 177 
high-resolution graphics 36 
YO 142 
low-resolution graphics 35 
main memory 75 
RAM 76 
memory pages, reserved 77-81 
microprocessor See 
6502 microprocessor; 
65C02 microprocessor 
Mini-Assembler 123-126 
errors 125 
instruction formats 126 
starting 123 
MIXED soft switch 29 
MMU 5, 6, 164-165 
Monitor, System 100-129 
command summary 127-129 
command syntax 101 
creating commands 119 
firmware subroutines 46-71 
returning to BASIC 115 
ROM listings 307-347 
use of page 3 8 
use of page zero 79 
Monitor ROM 168-169 
listings 307-347 
MouseText characters 17, 19, 246 
MOVE command 107-108, 117 
MOVE subroutine 223 
MSLOT 150, 154 


N 


NAK character 54 
negative decimal values 12 
converting 239-240 
NEXTCOL subroutine 223 
9-pin connectors 8, 40 
NORMAL command 270-271 
normal format 19-20, 114 
NTSC standard 16, 25, 173 


(e) 


Open Apple (G) 11, 13, 228 

operating systems 233-234 

original Apple Ile See differences 
between original and enhanced 
Apple Ile 

output See I/O 

overheating 158 


Pp 


Page 1 
double-high-resolution 79 
high-resolution 23, 27, 79 
text 27, 78 
Page 2 
high-resolution 23, 79 
text 27, 79 
page 3 vectors 97 
page zero 77, 79-81 
PAGEZ soft switch 29, 32, 87, 89, 
90 
pages, reserved memory 77-81 
PAL device 5, 167-168 
parity for SSC 279 
Pascal xx, 235, 275 
and bank-switched memory 82 
I/O subroutines 46 
starting up with 267-268 
Pascal 1.1 firmware protocol 68-71, 
144, 145-146 
Pascal operating system 234 
period (.) as Monitor command 102 
peripheral address bus 192, 194 
peripheral cards 
device assignment 145 
I/O memory space 133, 141 
programming for 132-156 
RAM space 136 
ROM space 133-135 
peripheral data bus 192 
differences in Apple II family 
231 
peripheral slots See expansion slots 
@0 (phi 0) 162, 170, 171, 
180-181 
@1 (phi 1) 162, 170, 171, 
180-181 
@2 (phi 2) 162 


phone jacks 8, 39 
PINIT subroutine 69 
pipelining 161 
PLOT subroutine 67, 223 
POKE command 271-272 
power connector 160 
power supply 4, 159-160 
PR# command 115 
PRBL2 subroutine 67, 224 
PRBLNK subroutine 224 
PRBYTE subroutine 67, 224 
PREAD subroutine 43, 69, 224 
PRERR subroutine 67, 224 
PRHEX subroutine 68, 224 
primary character set 19-20, 228 
PRINTER command 115 
PRNTAX subroutine 68, 224 
ProDOS 105, 141, 233 
interrupt support 148-149 
starting up with 268 
use of page 3 78 
use of page zero 81 
ProFile hard disk xxii 
Programmed Array Logic (PAL) 
device 5, 167-168 
prompt characters 60 
PSTATUS subroutine 71 
PWRITE subroutine 69 


Q 


Q3 signal 163 
question mark (?) as prompt 
character 62 


R 
radio-frequency modulator 7 


addressing 139, 169-172 

allocation 76-81 

auxiliary 86-88 

space for peripheral cards 136 

timing signals 172 
RAMRD soft switch 88-90 
RAM upgrade xxiii 
RAMWART soft switch 88-90 
random number generator 59 
RDALTCHAR soft switch 29 
RDALTZP soft switch 84 
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RDBNK2 soft switch 84 
RDCHAR subroutine 224 
RDDHIRES soft switch 30 
RD80COL soft switch 29 
RD80STORE soft switch 29 
RDHIRES soft switch 30 
RDIOUDIS soft switch 30 
RDKEY subroutine 47, 58, 59, 
225, 269 
RDLCRAM soft switch 84 
RDMIXED soft switch 29 
RDPAGE2Z soft switch 29 
RDTEXT soft switch 29 
READ subroutine 40, 225 
READ tape command 113-114 
refreshing the display 170-171 
registers 146, 161 
accumulator 138, 148 
A register 146 
examining and changing 
110-111 
index 138 
X register 146 
Y register 146 
relative addressing 121, 126, 137 
reserved memory pages 77-81 
Reset 11, 14, 228 
reset routine 94-98 
and bank switches 83 
differences in Apple II family 
230 
reset vector 96-97 
Return Monitor command 127 
retype function 64 
RF modulator 7 
RGB-type monitor 185 
Right Arrow 64 
right bracket ( ] ) as prompt 
character 62 
rollover, N-key 10 
ROM 
addressing 168-169 
expansion 133-135 
interpreter 5 
keyboard 5 
Monitor listings 307-347 
space for peripheral cards 
133-135 
video 5 
ROMEN1 signal 168-169 
ROMEN2 signal 168-169 
R/W80 signal 197 
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$s 


schematic diagram 201-204 
SCRN subroutine 68, 225 
SEARCH command 110 
self-test 14, 98 
differences in Apple II family 
230 
SETCOL subroutine 68, 225 
SETINV subroutine 225 
SETNORM subroutine 225 
Shift 11 
Shift-key mod 41-42 
short circuits 160 
SI character 54 
signals 
auxiliary slot 197-200 
expansion slot 191-197 
game I/O connector 190-191 
IOU 166-167 
keyboard connector 187-188 
keypad connector 188 
MMU 165 
PAL device 167-168 
RAM timing 172 
65C02 timing 162-163 
speaker connector 189 
video connector 186 
video timing 180-181, 184 
signature byte 231 
single-wire Shift-key mod xxiii 
6502 microprocessor xx, 6 
differences from 65C02 6, 
209-210 
65C02 microprocessor xx, 6, 
209-219 
data sheet 210-219 
differences from 6502 6, 
209-210 
specifications 161-163 
timing 162-163 
65C02 stack 78 
slot, auxiliary 49-50 
slot number, finding 137 
slot 3 49-50, 149-150 
firmware 69 
in original Apple IIe 144 
slots, expansion 7, 132-144 
signals 191-197 
SLOTC3ROM soft switch 50, 143 
SLOTCXROM soft switch 143 
SO character 54 


soft switches 
auxiliary memory 87, 89 
bank switches 82-86, 88 
differences in Apple II family 
230 
display 28-31 
I/O memory 142-143 
implemented by IOU 166-167 
implemented by MMU 164 
speaker 39 
Solid Apple (#) 11, 13, 228 
SPC command xxi 
speaker 4, 38-39, 189 
connector 189 
soft switch 39 
specifications, environmental 158 
stack 
auxiliary 153-154 
main 153-154 
65C02 78 
stack pointers 78, 153 
standard I/O links 51 
address storage 78 
changing 140-141 
starting up 267-268 
startup drives xx—xxi 
stop-list feature 55 
strobe bit 13 
strobe output 41, 43 
STSBYTE 285 
SUB character 55 
subroutines 
directory of 220-226 
output 64-68 
Pascal I/O protocol 68-71 
standard I/O 46-71 
See also names of subroutines 
Super Serial Card 276-291 
command character 278 
commands 278-285 
error codes 285-286 
memory use 287-290 
scratchpad RAM 290-291 
terminal mode 286-287 
switch 0 41, 43 
switch 1 41, 43 
switches See soft switches 
switch inputs 41-42, 43 
SYN character 54 
System Monitor See Monitor, 
System 
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tabbing 271-272 
TAB command xxi 
with original Apple IIe 271-272 
television set 16 
temperature 
case 159 
operating 158 
text cards 86, 134, 150, 267—-275 
text character sets 
alternate 19-20 
primary 19-20, 228 
text display 19-21, 22, 178-181 
flashing format 57-58 
inverse format 19, 57-58 
normal format 19 
See also 40-column text; 
80-column text 
text Page 1 27, 78 
text Page 2 27, 79 
TEXT soft switch 29 
text window 56-57 
memory locations 57 
timing signals 
expansion slots 194 
RAM 172 
65C02 microprocessor 162-163 
video 180-181, 184 


U 


US character 55 
user's interrupt handler 154-155 
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vectors 
BRK 148 
interrupt 151 
IRQ 147-148 
page 3 97 
reset 96-97 
VERIFY command 109, 118 
VERIFY subroutine 226 
vertical sync 231 
VID7M signal 163 
video counters 173-174 
video display See display, video 
video monitor 16-17 — 
connector 8, 186 
video output signals 185-186 
video ROM 5 
video standards 173 
VLINE subroutine 68, 226 
voltage 
line 158 
supply 159 
VTABZ subroutine 68 
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WAIT subroutine 226 
warm-start reset 95 

WRITE subroutine 39, 226 
WRITE tape command 111-112 
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XFER subroutine 91, 93, 144, 153 
X register 146 
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Y register 146 
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zero page 77, 79-81 
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